White Labelling

What is it?

The main startup screen can be replaced with a background image and start button image of your choice. You can also change the colors of the menu items at the top of the screen, the event caption and the login status displayed at the bottom of the screen.

Example of a white labelled Start Screen verse the default

Background Image

All screens can be .jpg .png .gif .mov .mp4 unless otherwise stated

Portrait or Landscape Orientation

If the iPad is only going to be used in portrait or landscape orientation the background image should be 1536 × 2048px / 2048 × 1536px

Portrait and Landscape Orientation

If the iPad is going to be used in both portrait and landscape orientation the image should be square (2048 × 2048px) and will be displayed with the sides cropped when in portrait orientation or the top and bottom cropped when in landscape orientation.

Screenshot of the iOS Files app showing a white label background image for the startup screen

Defining a Filename Path

The path of the startup screen background image can also be defined in the settings.xml file using the tags:

These should specify the path of the background image relative to the iPad’s root folder e.g. to use a PNG image stored in an event it could be set to something like:
assets/event_name/startup_background.png

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<breeze_booth version="1.0" build="21">
  <device_settings>
    <startupScreenBackgroundImage>assets/event_name/startup_background.png</startupScreenBackgroundImage>
    ...
  </device_settings>
</breeze_booth>

Quick Setup Button

The quick setup button image is placed above the start button. It can be replaced by placing a PNG image named qrsetup.png in the Breeze Booth folder on the iPad.

The path of the quick setup button image can also be defined in the settings.xml file using the tag:

Example: assets/event_name/qrsetup_button.png

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<breeze_booth version="1.0" build="21">
  <device_settings>
    <qrSetupButtonImage>assets/event_name/qrsetup_image.png</qrSetupButtonImage>
    ...
  </device_settings>
</breeze_booth>

Start Button

The start button image is placed directly above the event caption. It can be replaced by placing a PNG image named start.png in the Breeze Booth folder on the iPad.

The path of the start button image can also be defined in the settings.xml file using the tag:

Example:
assets/event_name/start_button.png

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<breeze_booth version="1.0" build="21">
  <device_settings>
    <startButtonImage>assets/event_name/start_button.png</startButtonImage>
    ...
  </device_settings>
</breeze_booth>

Customizing the Quick Setup Screen

The appearance of the quick setup screen can customized by placing a background screen image and/or an overlay image in the Breeze Booth folder on the iPad.

Separate screen images can be defined for when the iPad is in landscape or portrait orientation.

Specifying a Different Folder for the Start Screen Assets

The default folder for storing customized screens and buttons for the start and quick setup screens is the main Breeze Booth folder. This can be changed by specifying a different folder using the tag in the settings.xml file.

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<breeze_booth version="1.0" build="21">
  <device_settings>
    <startupScreenAssetsFolder>assets/startup</startupScreenAssetsFolder>
    ...
  </device_settings>
</breeze_booth>

If the <startupScreenAssetsFolder> tag is defined in the settings.xml file the app will look for button and screen images for the startup screen in the specified subfolder of the Breeze Booth folder.

Menu and Caption Colors

Change the colors of the menu, event and login status text by modifying the contents of the , and tags in the settings.xml file in the Breeze Booth folder on the iPad. Each color is defined by four attributes:

• red: the red component in the range 0.0 to 1.0
• green: the green component in the range 0.0 to 1.0
• blue: the blue component in the range 0.0 to 1.0
• alpha: the opacity range 0.0 to 1.0 where 0.0 is fully transparent and 1.0 is fully opaque

The captions can be made invisible by setting alpha to 0.0. Please note that the menu buttons will still be active even if they are not visible. The “Events” and “Sign Out” menu buttons can be hidden (and disabled) in the App Settings.

Example settings.xml

<?xml version="1.0" encoding="ISO-8859-1"?>
<breeze_booth build="23" version="1.0">
  <device_settings>
    <menuLabelColor red="0.0" blue="1.0" alpha="1.0" green="0.478431"/>
    <eventLabelColor red="1.0" blue="1.0" alpha="1.0" green="1.0"/>
    <loginStatusLabelColor red="1.0" blue="1.0" alpha="0.3" green="1.0"/>
    ...
  </device_settings>
</breeze_booth>