Convert to PDF

Apryse SDK allows you to convert non-pdf documents such as office and image files to PDF documents.

Android

Convert to PDF in Xamarin.Android

This tutorial only applies to Xamarin.Android. See Xamarin.iOS equivalent here .

For Android, available in the full version of the library only. See Apryse full or standard?

Internet connection is not required for conversion.

If you are already using any of DocumentActivity or PdfViewCtrlTabHostFragment2 , you will not need to go through this article as viewing other document types is already taken care of internally. Continue reading this article if you are not planning to use any of the above.

Saving annotations back to non-PDF formats is not supported. You can instead save the annotated PDFDoc to a PDF file.

PDFViewCtrl has a powerful and seamless conversion system which allows you to stream documents during conversion to PDF. It supports the following file types:

• Office file conversion: .docx, .pptx, .xlsx, .doc. (with the office conversion Add-On module)
• Image conversion: .bmp, .jpg, .tif, .png, .gif
• Image collections (zip archives with any type of image listed above)
• Markdown: .md (with the office conversion Add-On module)

In this tutorial you will be able to display a non-PDF file in PDFViewCtrl.

Before going forward, please make sure you have finished setting up PDFViewCtrl as described in Using PDFViewCtrl.

View a document

The easiest way to display a non-PDF file in PDFViewCtrl is through the PDFViewCtrl.openNonPDFUri API.

Option 1: from local device storage

** Storage Permission **

Please follow the latest Android best practices and guidelines outlined here

Add the following when you would like to show the document, typically onCreate or onResume of your Activity or Fragment:

var nonPdfUri = Android.Net.Uri.FromFile(new Java.IO.File("my_file_path"));
var documentConversion = pdfViewCtrl.OpenNonPDFUri(nonPdfUri, null);

Option 2: from content uri

Add the following when you would like to show the document, typically onCreate or onResume of your Activity or Fragment:

var nonPdfContentUri = Android.Net.Uri.Parse("my_content_uri");
var documentConversion = pdfViewCtrl.OpenNonPDFUri(nonPdfContentUri, null);

To monitor the conversion event, do:

pdfViewCtrl.UniversalDocumentConversion += (sender, e) =>
{
    if (e.State == PDFViewCtrl.ConversionState.Progress)
    {
        // conversion in progress
    }
    else if (e.State == PDFViewCtrl.ConversionState.Finished)
    {
        // conversion finished successfully
    }
    else if (e.State == PDFViewCtrl.ConversionState.Failed)
    {
        // conversion failed
    }
}

iOS

Convert to PDF in Xamarin.iOS

This tutorial only applies to Xamarin.iOS. See Xamarin.Android equivalent here .

Saving annotations back to non-PDF formats is not supported. You can instead save the annotated PDFDoc to a PDF file.

Apryse has a powerful conversion system which allows you to convert many file formats to PDF. The PTConvert class handles the conversion process and supports the following file types:

• Office files: .docx, .pptx, .xlsx, .doc (with the office conversion Add-On module)
• Images: .bmp, .jpg, .tif, .png, .gif
• Image collections (zip archives with any type of image listed above)
• Markdown files: .md (with the office conversion Add-On module)

Open a non-PDF file

The simplest way to convert and view any file format that Apryse supports is to use the PTDocumentController (or PTTabbedDocumentViewController) method openDocumentWithURL:. This method supports local files, files opened from remote cloud services and "raw" http URLs.

Convert a non-PDF file

Another way is to convert a file with the Convert class's StreamingPDFConversion(String, ConversionOptions) method. The following code shows how to convert a non-PDF file using Apryse's internal conversion:

var documentConversion = Convert.StreamingPDFConversion("my_file_path", null);
documentConversion.Convert();
var pdfDoc = documentConversion.GetDoc();

The result of the conversion will be contained in the provided PTPDFDoc, which can then be displayed.

Convert other non-PDF files

In addition to the file types supported by Apryse's internal conversion, it is also possible to convert many other file types with an iOS-specific API. The PTConvert class's +convertOfficeToPDF:paperSize:completion: method can convert any file type supported by WKWebView to PDF. Some of the supported file types include:

• iWork files: .pages, .key, .numbers
• Binary office files: .doc, .ppt, .xls
• Rich Text Format files: .rtf

The following code shows how to convert a file with the iOS-specific API:

pdftronprivate.PTConvert.ConvertOfficeToPDF("", CGSize.Empty, (pathToPDF) => { 
    if (pathToPDF == null) {
        // Failed to convert HTML to PDF.
        return;
    }
    var dirs = NSSearchPath.GetDirectories(NSSearchPathDirectory.DocumentDirectory, NSSearchPathDomain.User, false);
    var documentDirectory = dirs[0];

    var urlToPdf = new NSUrl(pathToPDF);
    var destinationURL = (new NSUrl(documentDirectory)).Append(urlToPdf.LastPathComponent, false);

    NSError error = null;
    var result = NSFileManager.DefaultManager.Copy(urlToPdf, destinationURL, out error);
    if (!result) {
        // Failed to copy PDF to persistent location.
    }

    // Do something with PDF output.
});

Convert HTML to PDF

Please see this guide about Web/HTML to PDF.