Screens Displayed to the User

Top  Previous  Next

Each screen consists of an optional JPEG background image overlaid by the live images from the camera which in turn are overlaid by an optional animated GIF and PNG overlay image and optional video with alpha channel. The various image files should have the same filename as the main screen image e.g. ready.jpg, ready.gif and ready_overlay.png.

 

To get the best quality, screen images should match the size and aspect ratio of the iPad's screen.The table below shows the screen resolutions and aspect ratios of recent iPad models:

 

Standard iPads and iPad Pro 9.7

2048 x 1536 pixels (4:3 aspect ratio)

iPad Pro 12.9 (1st and 2nd generations)

2732 x 2048 pixels (4:3 aspect ratio)

iPad Pro 10.5

2224 x 1668 pixels (4:3 aspect ratio)

iPad Pro 11

2388 x 1668 pixels (aspect ratio slightly narrower than 4:3)

 

If the screen image is not the same size as the screen it will be resized to fit. This may cause the image to be stretched if its aspect ratio does not match that of the screen.

 

Please note: The event editor has two settings for the screen aspect ratio: "4:3 (most iPads)" and iPad Pro 11". When this is set to 4:3 the screens will fill the screen of most iPads but the iPad Pro 11" will display the screens with a small black border at the top and bottom. When this is set to iPad Pro 11" the screens will fill the iPad Pro 11"'s screen and will be displayed with a small black border on the sides of other iPads.

 

Animated GIFs are displayed over JPEG background images and the live feed from the camera and can contain transparent areas. Please note that the GIF format only supports fully opaque or fully transparent areas.

 

PNG overlays are displayed over the JPEG background, live feed from the camera and animated GIF and can contain transparent and semi-transparent areas. The alpha channel of the PNG image can be used to give full control over the transparency of the overlay from fully transparent through semi-transparent to fully opaque.

 

Videos are displayed over the JPEG background, live feed from the camera, animated GIF and PNG overlays. Videos can be in MP4 format (with a .mp4 file extension) or Apple QuickTime format (with a MOV file extension). QuickTime videos saved in HEVC format can contain an alpha channel to give full control over the transparency of the video from fully transparent through semi-transparent to fully opaque.

 

Screens

 

default_background.jpg - default background image for any screen that does not explicitly define a JPEG background

ready.jpg, ready.gif, ready_overlay.png - ready screens displayed in photo mode

ready_info<n>.jpg, ready_info<n>.gif, ready_info<n>.png - info screens available from the photo ready screen (<n> is the page number starting from 1)

menu1.jjpg, menu1.gif, menu1.png, menu1_selected.png - screens for displaying menu 1 (only available from the ready screens)

menu2.jjpg, menu2.gif, menu2.png, menu2_selected.png - screens for displaying menu 2 (only available from the ready screens)

<n>.jpg, <n>.png, <n>.gif - countdown screen in photo mode (<n> is the photo number starting from 1)

taking.jpg, taking.gif, taking.png - displayed after the countdown when the photo is being taken in photo mode

preview.jpg, preview.gif, preview.png - displayed with the optional preview after taking each photo in photo mode

processing.jpg, processing.gif, processing.png - displayed while preparing the print layout after taking all the photos in photo mode

confirm_printing.jpg, confirm_printing.gif, confirm_printing.png - displayed when the option print confirmation screen is shown after preparing the print layout in photo mode

share.jpg, share.gif, share.png - displayed while sharing the print layout in photo mode

share_slideshow.jpg, share_slideshow.gif, share_slideshow.png - displayed while sharing theGIF or MP4 slideshow in photo mode

share_info<n>.jpg, share_info<n>.gif, share_info<n>.png - info screens available from the sharing screens screen (<n> is the page number starting from 1)

 

gif_ready.jpg, gif_ready.gif, gif_ready.png - ready screens displayed in burst GIF mode

gif_ready_info<n>.jpg, gif_ready_info<n>.gif, gif_ready_info<n>.png - info screens available from the burst GIF ready screen (<n> is the page number starting from 1)

gif_countdown.jpg, gif_countdown.gif, gif_countdown.png - displayed during the countdown in burst GIF mode

gif_capture.jpg, gif_capture.gif, gif_capture.png - displayed when the GIF is being recorded after the countdown in burst GIF mode

gif_processing.jpg, gif_processing.gif, gif_processing.png - displayed while creating GIF and/or MP4 video after capture in burst GIF mode

gif_playback.jpg, gif_playback.gif, gif_playback.png - displayed when playing back an animated GIF or MP4 video captured in burst GIF mode

gif_share.jpg, gif_share.gif, gif_share.png - displayed while sharing GIFs or MP4 videos in burst GIF mode

 

sending_email.jpg, sending_email.gif, sending_email.png - displayed when sending an email

sending_textl.jpg, sending_textl.gif, sending_text.png - displayed when sending a text

standby.jpg, standby.gif, standby.png - displayed while in standby mode (the camera live feed is disabled to save power in standby mode)

 

Notes:

1.Different ready screens can be displayed to show the currently selected filter style and mirroring options by adding the style name to the filename e.g. ready_normal_overlay.png, ready_monochrome_overlay.png, ready_sepia_overlay.png, ready_comic_overlay.png
2.The number of print copies selected can be displayed either as text using the confirm_printing screens or as separate screen images for each number of copies by appending the number of copies to the filename e.g. confirm_printing_1.jpg, confirm_printing_2.jpg, confirm_printing_3.jpg etc.
3.Countdown text is displayed in the countdown screens unless there is an animated GIF for countdown in which case the countdown ends after the GIF has been played once
4.The sending_email and sending_text screens are displayed briefly to provide the user with visual feedback but don't mean that the email or text has actually been sent. Local texts and emails are passed to the iPads native Messaging and Mail apps and are sent in the background when the iPad is connected to the internet. Other emails and texts are saved as XML files and need to be processed externally e.g. using Breeze Hub

 

The sequence of screens displayed during a typical two photo shooting sequence in photo mode is:

ready.jpg/ready.gif/ready_overlay.png - ready screen

1.jpg/1.gif/1.png - countdown for the first photo

taking.jpg/taking.gif/taking.png - taking the first photo

preview.jpg/preview.gif/preview.png - preview of the first photo

2.jpg/2.gif/2.png - countdown for the second photo

taking.jpg/taking.gif/taking.png - taking the second photo

preview.jpg/preview.gif/preview.png - preview of the second photo

processing.jpg/processing.gif/processing.png - preparing the print layout

confirm_printing.jpg/confirm_printing.gif/confirm_printing.png - displaying the print layout asking for confirmation

share.jpg/share.gif/share.png - sharing the print layout

sending_email.jpg/sending_email.gif/sending_email.png - emailing the print layout

share.jpg/share.gif/share.png - sharing the print layout

ready.jpg/ready.gif/ready_overlay.png - return to the ready screen ready for the next session

 

The sequence of screens displayed capturing a typical GIF in burst GIF mode is:

gif_ready.jpg/gif_ready.gif/gif_ready.png - ready screen

gif_countdown.jpg/gif_countdown.gif/gif_countdown.png - countdown before starting capture

gif_capture.jpg/gif_capture.gif/gif_capture.png - capturing the burst GIF

gif_processing.jpg/gif_processing.gif/gif_processing.png - creating the animated GIF and/or MP4 video

gif_playback.jpg/gif_playback.gif/gif_playback.png - displaying GIF or MP4 and asking for confirmation

gif_share.jpg/gif_share.gif/gif_share.png - sharing the GIF or MP4

sending_email.jpg/sending_email.gif/sending_email.png - emailing the print layout

gif_share.jpg/gif_share.gif/gif_share.png - sharing the GIF or MP4

gif_ready.jpg/gif_ready.gif/gif_ready_overlay.png - return to the ready screen ready for the next session

 

Please see Keyboards and Surveys for information about the touchscreen keyboards that are displayed for optional surveys at the start of the shooting sequence and for entering email addresses and phone numbers when sharing.

Please see Menus for information about displaying menus

 

Tips for using the default_background.jpg screen image

The default_background.jpg screen image provides a default background image for any screen that does not explicitly define a JPEG background. If you define all buttons and menus using PNG overlays you can use the default_background.jpg image to provide the screen backgrounds. This reduces the number of screen images required for an event and also makes it easier to change the appearance of an event because there is only one background image to edit.

You can also create more fluid screen transitions by using a constant background image with buttons and menus provide as overlays by setting the overlay fade time in the general settings.

 

The easiest way to see how the screens work is to take a look at the sample events that come with the event editor or to use the event creator to create an event and its screens.

 

 

Animated GIFs

 

Each screen can be animated using an optional animated GIF by creating a GIF with the same name as the main screen image e.g. ready.gif for the ready.jpg screen.

If the GIF should play in a continuous loop the suffix _loop should be added to the filename e.g. ready_loop.gif.

 

By default the animated GIF will be centered on the screen. The position can be specified by appending the following modifiers enclosed in curly brackets to the end of the filename:

T - place the center of the animated GIF at the top of the screen

B - place the center of the animated GIF at the bottom of the screen

L - place the center of the animated GIF at the left of the screen

R - place the center of the animated GIF at the right of the screen

W - width of the animated GIF

H - height of the animated GIF

Each modifier can be followed by a number (to specify the offset in pixels) or a number followed by % (to specify the percentage offset wrt the screen size).

 

Examples:

ready.gif - place a GIF that plays once in the ready screen and place it in the center of the screen

ready_loop.gif - place a GIF that plays in a continuous loop in the ready screen and place it in the center of the screen

ready_loop_{T}.gif - place a GIF that plays in a continuous loop in the ready screen and place its center at the top of the screen (the top half will be off the screen), centered horizontally

ready_loop_{T50}.gif - place a GIF that plays in a continuous loop in the ready screen and place its center 50 pixels down from the top of the screen, centered horizontally

ready_loop_{T10%}.gif - place a GIF that plays in a continuous loop in the ready screen and place its center 10% of the screen height from the top of the screen, centered horizontally

ready_loop_{T10%L}.gif - place a GIF that plays in a continuous loop in the ready screen and place its center on the left of the screen and 10% of the screen height from the top of the screen

ready_loop_{B100R50}.gif - place a GIF that plays in a continuous loop in the ready screen and place its center 50 pixels from the right side of the screen, 100 pixels from the bottom of the screen

ready_loop_{T10%W10%}.gif - place a GIF that plays in a continuous loop in the ready screen and place its center 10% of the screen height from the top of the screen, centered horizontally and resize to 10% of the screen width

 

 

Video Animations

 

Each screen can be animated using an optional video by creating a MP4 or MOV file with the same name as the main screen image e.g. ready.mov for the ready.jpg screen.

 

If the video should play in a continuous loop the suffix _loop should be added to the filename e.g. ready_loop.mov. By default the video will be centered on the screen. The size and position can be specified by appending the modifiers enclosed in curly brackets to the end of the filename. This works in exactly the same way as animated GIFs and is explained in the previous section.

 

Videos with alpha channels allow the transparency of the video to be controlled on a frame by frame and pixel by pixel basis. This makes it possible to create a video which has some areas that are fully transparent and other areas with varying transparency from semi-transparent to fully opaque.

 

Videos with alpha channels used animate screens in Breeze Booth for iPad need to be saved as QuickTime files in HEVC format. The HEVC video format with alpha channels is relatively new and does not yet have widespread support. Many high end video editing tools can create videos with alpha channels in Apple ProRes 4444 format which can then be converted to HEVC format. This can be done using Apple's QuickTime Player that comes free with macOS Catalina. QuickTime Player also has the ability to load a series of PNG images with alpha channels and then export them as an HEVC video.

 

Please note: Alpha videos require iPadOS 13 or later on iPads and iOS 13 or later on iPhones.

 

Music Files

 

Sound can be added to the screens by adding a MP3 file with the same name as the screen being displayed e.g. name the file ready.mp3 to play a sound when the ready.jpg screen is displayed. The MP3 file will play for its full duration unless another MP3 file replaces it. If you want to cancel a long MP3 file when the next screen is displayed you can use a short silent file with the name of the next screen.

 

Watermarks

 

When the iPad is not signed in it runs in free mode which allows up to 10 sets of photos or GIFs to be captured each day before a watermark is applied to the live view images and all output. The watermark that is applied to GIFs and print layouts is fixed but the watermark that is displayed over live view images can be replaced with a PNG image named live_view_watermark.png.