Image Gallery

The Image Gallery feature allows you to create a swipeable gallery of a group of image files through a custom URL scheme. The resulting URL can be set as the app's homepage, a custom link in the bottom navigation bar, or as a link in an HTML page.

Image files must be stored locally on the device. Supported formats include .jpg and .png.

Using this URL scheme, you can set the path to your images, set an overlay image that will appear on every slide (optional), and choose the opacity for the overlay image (optional).

Using the .xml file makes it easier to add or reorder pieces of content as it does not require that you rename a large number of files when a change is needed. You can choose to order the files by the order they are listed in the .xml using <order_type>0</order_type>, randomly using <order_type>1</order_type>, or alphabetically/numerically using <order_type>2</order_type>.

The file must be named ‘slide_show_settings.xml’ and be placed in the same folder on the device as the images being shown. Additional images can be defined by adding additional <slide path='content.ext'/> entries.

Overlay Image

overlay-path=[path-to-overlay-image]

The overlay image is an image that will be displayed in front of every image in the gallery. We recommend making this a transparent PNG file the same resolution as your iPad. If your overlay image is called "overlay.png" and is directly in Kiosk Pro's documents folder, this portion of the scheme would be:

overlay-path=overlay.png

Overlay Opacity

overlay-alpha=[0-1]

The overlay opacity lets you set how opaque the image is. With an opacity of 1, the image will be completely visible, and an opacity of 0 would make it completely invisible. The number set here can be 0, 1 or a decimal (like 0.8). If you wanted the opacity to be at 50%, this portion of the scheme would be:

overlay-alpha=0.5

If an overlay opacity is not set in the scheme, the default will be 1 (completely visible).

Example

For a folder of images in the Kiosk Pro documents folder called "slideshow", and an overlay image directly in the documents folder called "overlay.png" which you wanted to be 50% opaque, your scheme would be: