- Its take `A4, A3, A2` this specify the format of the paper, just available in iOS, in Android this option is ignored.

##### type

- `base64` it will return a Base64 representation of the PDF file. `{ type: 'base64' } , is not type is provided this one is choosen by default.

``js
let options = {
documentSize: 'A4',
type: 'base64'
}

pdf.fromData('

Hello World


`

- `share` It will delegate the file to the OS printing infraestructure, this basically will allow the user to handle the file himself using the mobile OS features available.

`js
let options = {
documentSize: 'A4',
type: 'share'
}

pdf.fromData( '

Hello World

`

##### filename

- You can specify the name of the PDF file.

`js
let options = {
documentSize: 'A4',
type: 'share',
fileName: 'myFile.pdf'
}

pdf.fromData( '

Hello World

`

`

##### Loading from Device Filesystem.

`js

//Example: file:///android_asset/index.html

function printInternalFile(param) {

/ generate pdf using url. /
if(cordova.platformId === 'ios') {

// To use window.resolveLocalFileSystemURL, we need this plugin https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-file/
// You can add this by doing cordova plugin add cordova-plugin-file or
// cordova plugin add https://github.com/apache/cordova-plugin-file
window.resolveLocalFileSystemURL(cordova.file.applicationDirectory,
(url) => {
var file = param.replace('file:///android_asset/',url.nativeURL);

pdf.fromURL(file, {
documentsize: 'a4',
landscape: 'portrait',
type: 'share'
})
.then((stats)=> this.preparetogobackground )
.catch((err)=> this.showerror)
},
(err) =>
console.log('error', err, ' args ->', arguments)
);
}else {
pdf.fromURL(param, {
documentsize: 'a4',
landscape: 'portrait',
type: 'share'
})
.then((stats)=> this.preparetogobackground )
.catch((err)=> this.showerror)
}
}
`

##### Ionic/Angular 2 Example:

`js
import { Component } from '@angular/core';

import { NavController } from 'ionic-angular';

declare var cordova:any; //global;

@Component({
selector: 'page-home',
templateUrl: 'home.html'
})
export class HomePage {

constructor(public navCtrl: NavController) {
const before = Date.now();

document.addEventListener('deviceready', () => {
console.log('DEVICE READY FIRED AFTER', (Date.now() - before), 'ms');

//generate the pdf.
cordova.plugins.pdf.fromData( '

Hello World

`

##### Saving a pdf file directly into the file system

If you'd like to directly save the pdf file into the Downloads directory of the device, or any other, without asking the user for what to do with the file, you will need to use type as base64 and then use such information to save the pdf into a file. For this you will need the plugin cordova-plugin-file.

Here is an example

`js
var fileName = "myPdfFile.pdf";

var options = {
documentSize: 'A4',
type: 'base64'
};

var pdfhtml = 'This is the pdf content';

pdf.fromData(pdfhtml , options)
.then(function(base64){
// To define the type of the Blob
var contentType = "application/pdf";

// if cordova.file is not available use instead :
// var folderpath = "file:///storage/emulated/0/Download/";
var folderpath = cordova.file.externalRootDirectory + "Download/"; //you can select other folders
savebase64AsPDF(folderpath, fileName, base64, contentType);
})
.catch((err)=>console.err(err));

`

You will also need these two functions. Due to javascript functions hoisting you can declare them afterwards as here:

`js
/**
* Convert a base64 string in a Blob according to the data and contentType.
*
* @param b64Data {String} Pure base64 string without contentType
* @param contentType {String} the content type of the file i.e (application/pdf - text/plain)
* @param sliceSize {Int} SliceSize to process the byteCharacters
* @see http://stackoverflow.com/questions/16245767/creating-a-blob-from-a-base64-string-in-javascript
* @return Blob
*/
function b64toBlob(b64Data, contentType, sliceSize) {
contentType = contentType || '';
sliceSize = sliceSize || 512;

var byteCharacters = atob(b64Data);
var byteArrays = [];

for (var offset = 0; offset < byteCharacters.length; offset += sliceSize) {
var slice = byteCharacters.slice(offset, offset + sliceSize);

var byteNumbers = new Array(slice.length);
for (var i = 0; i < slice.length; i++) {
byteNumbers[i] = slice.charCodeAt(i);
}

var byteArray = new Uint8Array(byteNumbers);

byteArrays.push(byteArray);
}

var blob = new Blob(byteArrays, {type: contentType});
return blob;
}

/**
* Create a PDF file according to its database64 content only.
*
* @param folderpath {String} The folder where the file will be created
* @param filename {String} The name of the file that will be created
* @param content {Base64 String} Important : The content can't contain the following string (data:application/pdf;base64). Only the base64 string is expected.
*/
function savebase64AsPDF(folderpath,filename,content,contentType){
// Convert the base64 string in a Blob
var DataBlob = b64toBlob(content,contentType);

console.log("Starting to write the file :3");

window.resolveLocalFileSystemURL(folderpath, function(dir) {
console.log("Access to the directory granted succesfully");
dir.getFile(filename, {create:true}, function(file) {
console.log("File created succesfully.");
file.createWriter(function(fileWriter) {
console.log("Writing content to file");
fileWriter.write(DataBlob);
}, function(){
alert('Unable to save file in path '+ folderpath);
});
});
});
}
`

#### Deprecated

Here are examples to use the deprecated methods.

This generates a pdf from a URL, it convert HTML to PDF and returns the file representation in base64.

`js
document.addEventListener('deviceready', function() {

pdf.htmlToPDF({
url: 'http://www.google.es',
documentSize: 'A4',
landscape: 'portrait',
type: 'base64'
}, this.success, this.failure);

});
`

The same but giving HTML without URL.

`js
document.addEventListener('deviceready', function() {

pdf.htmlToPDF({
data: '

Hello World

`

Opening the pdf with other app menu.

`js
document.addEventListener('deviceready', function() {

pdf.htmlToPDF({
data: '

Hello World

});
``