Convert multiple format types to PDF

There are two options to convert a supported file format to a PDF document. First is using the PDFViewCtrl.openNonPDFUri method, which does the conversion asynchronously in the viewer and provides callbacks for handling conversion progress. The second uses the Convert API, which simply converts the document to PDF in a blocking manner.

UI component

Convert multiple formats to PDF in Android

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:

Java

try {
    Uri nonPdfUri = Uri.fromFile(new File("my_file_path"));
    DocumentConversion documentConversion = pdfViewCtrl.openNonPDFUri(nonPdfUri, null);
} catch (Exception ex) {
    ex.printStackTrace();
}

Kotlin

try {
  val nonPdfUri = Uri.fromFile(File("my_file_path"))
  val documentConversion = pdfViewCtrl.openNonPDFUri(nonPdfUri, null)
} catch (ex: Exception) {
  ex.printStackTrace()
}

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:

Java

try {
    Uri nonPdfContentUri = Uri.parse("my_content_uri");
    DocumentConversion documentConversion = pdfViewCtrl.openNonPDFUri(nonPdfContentUri, null);
} catch (Exception ex) {
    ex.printStackTrace();
}

Kotlin

try {
  val nonPdfContentUri = Uri.parse("my_content_uri")
  val documentConversion = pdfViewCtrl.openNonPDFUri(nonPdfContentUri, null)
} catch (ex: Exception) {
  ex.printStackTrace()
}

To monitor the conversion event, do:

Java

pdfViewCtrl.addUniversalDocumentConversionListener(new PDFViewCtrl.UniversalDocumentConversionListener() {
    @Override
    public void onConversionEvent(PDFViewCtrl.ConversionState state, int totalPagesConverted) {
        switch (state) {
            case PROGRESS:
                // conversion in progress
                break;
            case FINISHED:
                // conversion finished successfully
                break;
            case FAILED:
                // conversion failed
                if (documentConversion != null) {
                    try {
                        Log.e("MainActivity", "Conversion failed: " + documentConversion.getErrorString());
                    } catch (Exception ignored) {}
                }
                break;
        }
    }
});

Kotlin

pdfViewCtrl.addUniversalDocumentConversionListener(PDFViewCtrl.UniversalDocumentConversionListener { state, totalPagesConverted ->
    when (state) {
        PDFViewCtrl.ConversionState.PROGRESS -> {// conversion in progress
        }
        PDFViewCtrl.ConversionState.FINISHED -> {// conversion finished successfully
        }
        PDFViewCtrl.ConversionState.FAILED ->
            // conversion failed
            if (documentConversion != null) {
                try {
                    Log.e("MainActivity", "Conversion failed: " + documentConversion.getErrorString())
                } catch (ignored: Exception) {
                }

            }
    }
})

API guide

API to convert multiple formats to PDF in Android

To convert different formats to PDF Documents.

See all supported formats here: Supported File Formats .

Java

// Start with a PDFDoc (the conversion destination)
PDFDoc doc = new PDFDoc();

// perform the conversion with no optional parameters
Convert.toPdf(doc, filename);

Kotlin

// Start with a PDFDoc (the conversion destination)
val doc = PDFDoc()

// perform the conversion with no optional parameters
Convert.toPdf(doc, filename)