Converting and viewing other document types

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

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.

Displaying

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

Option 1: from local device storage

To access device storage, add the following permissions to AndroidManifest.xml file outside of the <application> tag:

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

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

try {
    Uri nonPdfUri = Uri.fromFile(new File("my_file_path"));
    DocumentConversion documentConversion = pdfViewCtrl.openNonPDFUri(nonPdfUri, null);
} catch (Exception ex) {
    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:

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

To monitor the conversion event, do:

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;
        }
    }
});