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 an optional 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:
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 several settings for the screen aspect ratio: 4:3 (most iPads), iPad Air 10.9", iPad Pro 11", "16:9 (most iPhones)" or "19.5:9 (iPhone X series)". When this is set to 4:3 the screens will fill the screen of most iPads but the iPad Air 10.9" and 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. iPhones have a narrower aspect ratio than iPads (either 16:9 or 19.5:9) and will display an event designed for a 4:3 aspect ratio iPad with a large black border at the top and bottom of the screen.
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.mov/mp4, ready_overlay.png - ready screens displayed in photo mode ready_overlay_qr.png - optional screen to provide visual feedback when a QR code is scanned in the ready screen ready_info<n>.jpg, ready_info<n>.gif, ready_info<n>.mov/mp4, ready_info<n>.png - info screens available from the photo ready screen (<n> is the page number starting from 1) menu1.jpg, menu1.gif, menu1.png, menu1_selected.png - screens for displaying menu 1 (only available from the ready screens) menu2.jpg, menu2.gif, menu2.png, menu2_selected.png - screens for displaying menu 2 (only available from the ready screens) menu3.jpg, menu3.gif, menu3.png, menu3_selected.png - screens for displaying menu 3 (only available from the ready screens) menu4.jpg, menu4.gif, menu4.png, menu4_selected.png - screens for displaying menu 4 (only available from the ready screens) <n>.jpg, <n>.png, <n>.gif, <n>.mov/mp4 - countdown screen in photo mode (<n> is the photo number starting from 1) countdown.jpg, countdown.png, countdown.gif, countdown.mov/mp4 - default countdown screen used if the numbered countdown screens aren't found taking.jpg, taking.gif, taking.mov/mp4, taking.png - displayed after the countdown when the photo is being taken in photo mode af_error.jpg, af_error.gif, af_error.mov/mp4, af_error.png - displayed if an AF error occurs when using an external camera af_abort.jpg, af_abort.gif, af_abort.mov/mp4, af_abort.png - displayed before returning to the ready screen if AF fails three times when using an external camera preview.jpg, preview.gif, preview.mov/mp4, preview.png - displayed with the optional preview after taking each photo in photo mode processing.jpg, processing.gif, processing.mov/mp4, processing.png - displayed while preparing the print layout after taking all the photos in photo mode confirm_printing.jpg, confirm_printing.gif, confirm_printing.mov/mp4, confirm_printing.png - displayed when the option print confirmation screen is shown after preparing the print layout in photo mode printing.jpg, printing.gif, printing.mov/mp4, printing.png - displayed when printing using AirPrint or printing from the sharing gallery share.jpg, share.gif, share.mov/mp4, share.png - displayed while sharing the print layout in photo mode share_slideshow.jpg, share_slideshow.png - displayed while sharing an animated GIF or MP4 slideshow in photo mode share_info<n>.jpg, share_info<n>.gif, share_info<n>.mov/mp4, share_info<n>.png - info screens available from the sharing screens screen (<n> is the page number starting from 1) after_session.jpg, after_session.gif, after_session.mov/mp4, after_session.png - screen shown after photo booth ends when using timed sessions. power_saving.jpg, power_saving.gif, power_saving.mov/mp4, power_saving.png - power saving screens displayed when power saving is active
Different "taking" screens can be displayed for each photo in the sequence by appending the photo number to the filename e.g. taking1.png for the first photo, taking2.png for the second photo etc. Different "preview" screens can be displayed for each photo in the sequence by appending the photo number to the filename e.g. preview1.png for the first photo, preview2.png for the second photo etc.
video_ready.jpg, video_ready.gif, video_ready.mov/mp4, video_ready.png - ready screens displayed in video mode video_ready_info<n>.jpg, video_ready_info<n>.gif, video_ready_info<n>.mov/mp4, video_ready_info<n>.png - info screens available from the video ready screen (<n> is the page number starting from 1) video_ready_overlay_qr.png - optional screen to provide visual feedback when a QR code is scanned in the video ready screen video_countdown.jpg, video_countdown.gif, video_countdown.mov/mp4, video_countdown.png - displayed during the countdown in video mode countdown.jpg, countdown.png, countdown.gif, countdown.mov/mp4 - default countdown screen used if the video_countdown countdown screen isn't found video_capture.jpg, video_capture.gif, video_capture.mov/mp4, video_capture.png - displayed when the video is being captured after the countdown in video mode video_processing.jpg, video_processing.gif, video_processing.mov/mp4, video_processing.png - displayed while the video after capture in video mode video_playback.jpg, video_playback.png - displayed when playing back a video captured in video mode video_share.jpg, video_share.png - displayed while sharing videos in video mode
gif_ready.jpg, gif_ready.gif, gif_ready.mov/mp4, gif_ready.png - ready screens displayed in burst GIF mode gif_ready_info<n>.jpg, gif_ready_info<n>.gif, gif_ready_info<n>.mov/mp4, gif_ready_info<n>.png - info screens available from the burst GIF ready screen (<n> is the page number starting from 1) gif_ready_overlay_qr.png - optional screen to provide visual feedback when a QR code is scanned in the GIF ready screen gif_countdown.jpg, gif_countdown.gif, gif_countdown.mov/mp4, gif_countdown.png - displayed during the countdown in burst GIF mode countdown.jpg, countdown.png, countdown.gif, countdown.mov/mp4 - default countdown screen used if the gif_countdown countdown screen isn't found gif_capture.jpg, gif_capture.gif, gif_capture.mov/mp4, 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.mov/mp4, gif_processing.png - displayed while creating GIF and/or MP4 video after capture in burst GIF mode gif_playback.jpg, gif_playback.png - displayed when playing back an animated GIF or MP4 video captured in burst GIF mode gif_share.jpg, gif_share.png - displayed while sharing GIFs or MP4 videos in burst GIF mode
sending_email.jpg, sending_email.gif, sending_email.mov/mp4, sending_email.png - displayed when sending an email sending_text.jpg, sending_text.gif, sending_text.mov/mp4, sending_text.png - displayed when sending a text sending.jpg, sending.gif, sending.mov/mp4, sending.png - default sending screen used if the sending_email or sending_text screens aren't found standby.jpg, standby.gif, standby.mov/mp4, standby.png - displayed while in standby mode (the camera live feed is disabled to save power in standby mode)
gallery.jpg - background for the gallery thumbnail screen gallery_share.jpg, gallery_share.png - displayed when sharing photos from the gallery gallery_slideshow_share.jpg, gallery_slideshow_share.png - displayed when sharing slideshow animated GIFs or MP4s from the gallery gallery_gif_share.jpg, gallery_gif_share.png - displayed when sharing burst GIFs or MP4s from the gallery gallery_video_share.jpg, gallery_video_share.png - displayed when sharing videos from the gallery gallery_share_info<n>.jpg, gallery_share_info<n>.gif, gallery_share_info<n>.png - info screens available from the gallery sharing screens screen (<n> is the page number starting from 1)
Countdowns
The countdown displayed when capturing photos, burst GIFs or videos can be simple text or an animation. If there is a countdown animation file (GIF or video) the animation will be used for the countdown and the length of the animation will determine the duration of the countdown. If there is no countdown animation the countdown text will be displayed instead (photo settings, burst GIF settings or video settings).
In photo mode you can have separate countdowns for each photo e.g. 1.mov for the first photo, 2.mov for the second photo, 2.mov for the third photo etc.
When capturing burst GIFs you can have countdown animation specific to burst GIFs, e.g. gif_countdown.mov, or use the default countdown e.g. countdown.mov.
When capturing videos you can have countdown animation specific to videos, e.g. video_countdown.mov, or use the default countdown e.g. countdown.mov.
Ready Screens
Different ready screens can be displayed to show the currently selected filter style, mirroring options, whether face smoothing is enabled and the current value of the ready screen string. This is done by adding the style name, mirroring option etc. to the filename. When the photo booth is running the ready screen will automatically be updated if the user selects an option that changes the filter style, mirroring style, selects face smoothing or changes the ready screen string.
The filter style can be used to select the ready screen: ready.jpg, ready_overlay.png - default name for the ready background and overlay screens The available filter styles are: normal, monochrome, sepia, comic, filter1, filter2, filter3, filter4, filter5, filter6
The mirror style can also be used to select the ready screen: ready.jpg, ready_overlay.png - default name for the ready background and overlay screens
The available mirror styles are: off, mirrorLeftRight, mirrorTopBottom, swapTopHalves, mosaic2x2
Enabling the face smoothing filter can also be used to select the ready screen: ready.jpg, ready_overlay.png - default name for the ready background and overlay screens ready.jpg, ready_overlay.png - default name for the ready background and overlay screens The ready screen string can also be used to select different backgrounds when using AI background removal. The {readyScreenString} token can also be used to read the value of the ready screen string
Multiple options can be added to the filename by separating them with +. The options must be added to the filename in order with the filter option first followed by the mirroring option followed by the face smoothing e.g. ready_sepia+mirrorLeftRight+smoothing.jpg - ready screen displayed when the filter style is set to sepia and the mirror style is set to mirrorLeftRight and face smoothing is enabled
Notes:
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.mov/1.png - countdown for the first photo taking.jpg/taking.gif/taking.mov/taking.png - taking the first photo preview.jpg/preview.gif/preview.mov/preview.png - preview of the first photo 2.jpg/2.gif/2.mov/2.png - countdown for the second photo taking.jpg/taking.gif/taking.mov/taking.png - taking the second photo preview.jpg/preview.gif/preview.mov/preview.png - preview of the second photo processing.jpg/processing.gif/processing.mov/processing.png - preparing the print layout confirm_printing.jpg/confirm_printing.gif/confirm_printing.mov/confirm_printing.png - displaying the print layout asking for confirmation printing.jpg/printing.gif/printing.mov/printing.png - displayed when printing using AirPrint share.jpg/share.gif/share.mov/share.png - sharing the print layout sending_email.jpg/sending_email.gif/sending_email.mov/sending_email.png - emailing the print layout share.jpg/share.gif/share.mov/share.png - sharing the print layout ready.jpg/ready.gif/ready.mov/ready_overlay.png - return to the ready screen ready for the next session
The sequence of screens displayed capturing a video in video mode is: video_ready.jpg/video_ready.gif/video_read.mov/video_ready_overlay.png - ready screen video_countdown.jpg/video_countdown.gif/video_countdown.mov/video_countdown.png - countdown before starting capture video_capture.jpg/video_capture.gif/video_capture.mov/video_capture.png - capturing the burst GIF video_processing.jpg/video_processing.gif/video_processing.mov/video_processing.png - creating the animated GIF and/or MP4 video video_playback.jpg/video_playback.gif/video_playback.mov/video_playback.png - displaying GIF or MP4 and asking for confirmation video_share.jpg/video_share.gif/video_share.mov/video_share.png - sharing the GIF or MP4 sending_email.jpg/sending_email.gif/sending_email.mov/sending_email.png - emailing the print layout video_share.jpg/video_share.gif/video_share.mov/video_share.png - sharing the GIF or MP4 video_ready.jpg/video_ready.gif/video_ready.mov/video_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_read.mov/gif_ready_overlay.png - ready screen gif_countdown.jpg/gif_countdown.gif/gif_countdown.mov/gif_countdown.png - countdown before starting capture gif_capture.jpg/gif_capture.gif/gif_capture.mov/gif_capture.png - capturing the burst GIF gif_processing.jpg/gif_processing.gif/gif_processing.mov/gif_processing.png - creating the animated GIF and/or MP4 video gif_playback.jpg/gif_playback.gif/gif_playback.mov/gif_playback.png - displaying GIF or MP4 and asking for confirmation gif_share.jpg/gif_share.gif/gif_share.mov/gif_share.png - sharing the GIF or MP4 sending_email.jpg/sending_email.gif/sending_email.mov/sending_email.png - emailing the print layout gif_share.jpg/gif_share.gif/gif_share.mov/gif_share.png - sharing the GIF or MP4 gif_ready.jpg/gif_ready.gif/gif_ready.mov/gif_ready_overlay.png - return to the ready screen ready for the next session
Payment Screens When the print payment option is selected the following screens are displayed before printing photos: print_payment.jpg/print_payment.gif/print_payment.mov/print_payment.png - screen displayed when waiting for a payment print_payment_accepted.jpg/print_payment_accepted.gif/print_payment_accepted.mov/print_payment_accepted.png - screen displayed for 2 secs after a payment has been accepted print_payment_cancelled.jpg/print_payment_cancelled.gif/print_payment_cancelled.mov/print_payment_cancelled.png - screen displayed for 2 secs after a payment has failed or has been cancelled
When the share payment option is selected the following screens are displayed after the user has entered their email address or phone number before the message is sent: email_payment.jpg/email_payment.gif/email_payment.mov/email_payment.png - screen displayed when waiting for a payment before sending an email email_payment_accepted.jpg/email_payment_accepted.gif/email_payment_accepted.mov/email_payment_accepted.png - screen displayed for 2 secs after a payment has been accepted email_payment_cancelled.jpg/email_payment_cancelled.gif/email_payment_cancelled.mov/email_payment_cancelled.png - screen displayed for 2 secs after a payment has failed or has been cancelled text_payment.jpg/text_payment.gif/text_payment.mov/text_payment.png - screen displayed when waiting for a payment before sending a text text_payment_accepted.jpg/text_payment_accepted.gif/text_payment_accepted.mov/text_payment_accepted.png - screen displayed for 2 secs after a payment has been accepted text_payment_cancelled.jpg/text_payment_cancelled.gif/text_payment_cancelled.mov/text_payment_cancelled.png - screen displayed for 2 secs after a payment has failed or has been cancelled
Please see Payment System for more information on the print and sharing payment modes.
Keyboards, Surveys and Menus 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.
Overlay/Background Filename Suffix
The overlay/background suffix for photos, burst GIFs or videos provides a way to dynamically select overlays and backgrounds and can also be used to dynamically select the screen that is displayed. The overlay/background suffix can use tokens to extract data from the survey screens and other sources. The overlay/background filename suffix can be used to select the following screens in photo, burst GIF and video modes:
Example: Using a survey to select different backgrounds for photos when using AI background removal An example event showing how this works can be downloaded from the AI background removal page.
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 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_{T0%}.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_{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_{B10%R20%}.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 bottom of the screen and 20% of the screen width from the right 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
Most screens 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. QuickTime Player also has the ability to load a series of PNG images with alpha channels and then export them as an HEVC video.
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, videos 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 videos, 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. |