Size to Fit for PDF Display

Supported In:

Determines how PDFs are sized to fit on the screen.

Automatically Show Full Page displays the PDF so that the entire PDF page is sized to fit on the screen. If the screen changes orientation, the PDF will automatically be reloaded to refit the PDF for the new orientation.  This is the default as it allows a mix of landscape and portrait-oriented PDFs to automatically fit themselves to the screen without hiding any of the pages regardless of device orientation. 

As the full page is shown, no scrolling is required to view.  For documents with smaller text, you may want to enable zoom on PDF files, allowing the visitor to pinch and zoom to resize the current view. 

A standard letter-size PDF laid out in landscape orientation is shown below using Size to Fit > Automatically Show Full Page.  In the following examples, PDF Display > Background Color (RGB) or Image is configured to an orange shade to highlight where the PDF does not fill the screen. 

Automatically Zoom to Fill Screen displays the PDF so that it zooms to fill the entire screen, using the top right corner as a baseline for display. 

Parts of the PDF page that do not fit within the screen are accessible by scrolling. Unless the PDF is exactly sized to fit the aspect ratio of the iPad and accommodate any bars Kiosk Pro is set up to display, scrolling will be necessary when viewing a PDF in this mode.

This mode can be a good solution for projects featuring PDFs that are text-heavy or use smaller text that might be difficult to read if presented in 'Automatically Show Full Page' mode. 

Horizontally displays the PDF so that it always fills the width of the screen.  If zoom is required, the app uses the top right corner as a baseline for display.

Vertically displays the PDF so that each page fills the height of the screen.  If zoom is required, the app uses the top right corner as a baseline for display.  While this was the previous default, it has been replaced as it is inherently less flexible when showing a mix of landscape and portrait-oriented PDFs. 

URL Parameter

You can control how a specific PDF is sized through the URL parameter: 'kp_sizeToFit'.  If defined, this parameter overrides the sizing behavior configured in the app’s settings as follows:

• kp_sizeToFit=0 - Horizontally
• kp_sizeToFit=1 - Vertically
• kp_sizeToFit=2 - Automatically Show Full Page
• kp_sizeToFit=3 - Automatically Zoom to Fill Screen

For example: https://docs.kioskgroup.com/test.pdf?kp_sizeToFit=3