Presentation Settings

the presentation settings pane allows you to edit settings that relate to the entire presentation property lock as of the brightsign author ( brightauthor\ connected) 1 6 46 release, presentation settings contains a property lock feature if your presentation has a script or script plugin that contains functions to configure or change the network settings of the player (for example, html or a plugin that modifies device settings), check the property lock checkbox to ensure that your settings are not overwritten by bsn cloud property lock unchecked when this box is unchecked and the presentation is published, player properties are not locked and can be edited and updated through the properties docid\ uba8sfkmsajsibrbv4a6n panel in the network tab property lock checked when you check property lock and publish the presentation, users can no longer change the player property settings ( player name , overview, device configuration, logging , network settings and location ) through the bsn cloud properties panel the settings will appear greyed out when viewed in the properties panel of the player in the network tab however, the player property settings can still be changed through javascript or plugin script the player should reboot automatically when the presentation is published if it has not, reboot the player manually when the property lock setting changes, there can be a reporting delay of up to 10 minutes between the os, bsn, and the brightauthor\ connnected ui during the reporting delay, the ui may be out of sync with the player if you change the properties during this period, the ui will accept the changes and post them to bsn bsn will store and deliver those settings to the player, but the player will not respond to them (the properties of the player will be locked) the player will not apply your changes until the settings handler has been reenabled by the presentation presentation use this section to edit video and audio output settings display if you are using a series 5 player and brightsign author ( brightauthor\ connected) version 1 7 11 and beyond, note that the connector, target resolution, force resolution, enable ycbcr 10 bit output, target frame rate, orientation, and enable dolby vision fields described below have been moved to the screens tab connection type select the video connector that connects the player to the display target resolution choose a resolution that is compatible with your monitor see video modes docid\ qpml112mbhek7lbdguxnv for a list of supported video modes force resolution check this box to have the player output the selected resolution even if the display reports over hdmi® that it does not support it if this box is unchecked, the player will attempt to use the selected target resolution , but will then fall back to the highest resolution supported by the display if it is unsupported enable ycbcr 10 bit output check this box to output a 10 bit color video signal to the connected display see the video formats & codecs docid\ knsffwmtd4nswxm4bup0i for more details on supported 4k color spaces and bit depths enable full resolution graphics check this box to enable full resolution for the selected target resolution when this box is checked, the graphics plane (images, text, html animations, etc ) is rendered at the same size as the video output, rather than being upscaled to the output resolution after rendering this option is only available for certain video modes larger than 1920x1200; all smaller video modes user full resolution graphics automatically this setting is subject to additional restrictions based on the resolution and player model see full resolution graphics docid\ tjnw230kcx6i9tnihfcvd for full details enable dolby vision check this box to enable dolby vision on the video output the presentation will be limited to a single video zone with this option enabled this option is supported on xt244 and xt1144 models only target frame rate choose a frame rate that is compatible with your monitor orientation the monitor orientation for the presentation this property must be set when you create a presentation background color select a background color for the presentation this color will show through if there's no content on an area of the screen, or if the content has some level of transparency language select a language for your presentation this option affects the time/date display of clock zones only delay schedule change until current media item completes playback check this box to have the player wait until a media item completes playback to switch to a new scheduled presentation for multi zone presentations, the first media item to complete playback, no matter the zone, will trigger the scheduled presentation change if this box is unchecked, a player will switch from one scheduled presentation to another at the specified time regardless of current playback monitor overscan select an overscan setting to determine how the content fills the display screen no overscan – use full screen displays content to the edge of the video signal overscan – action safe area restricts the display area to a size that is compatible with most displays overscan – title safe area restricts the display area to a size that is much smaller than the generated video signal audio use the audio tab to configure audio mixing and output options audio volume set the minimum volume and maximum volume for the audio output (0 – 100) hdmi volume set the minimum volume and maximum volume for the hdmi output (0 – 100) if you are using brightsign author ( brightauthor\ connected) 1 7 11 or above and multiple hdmi outputs are available on the device, each will be displayed as in the image at right spdif volume set the minimum volume and maximum volume for the spdif output (0 – 100) audio configuration configure the audio routing for the presentation mixed audio pcm only multiple pcm audio sources (for example, from a video and audio file playing simultaneously) will be mixed into a single source for audio outputs differing sampling rates (e g 44 1 khz vs 48 khz) will be merged into a single rate of 48 khz this setting also allows for dynamic adding and removing of audio sources while audio is already playing auto level volume check this box to level all pcm audio streams on a particular audio output to a similar volume level mixed audio pcm / compressed the behavior is the same as the mixed audio pcm only setting, but compressed audio is supported as well this is either mixed pcm audio or a compressed audio source (compressed audio cannot be mixed), that can be routed to an audio output fixed audio audio sources are mixed only if their sampling rates match if you attempt to add or remove audio sources while audio is playing, playback will fail aux5 players do not support some audio options and those will not be displayed in the presentation settings auto level volume in mixed audio pcm only mode mixed audio pcm/ compressed mode support content use the support content section to add supplementary files to a presentation if you are in bsn cloud content mode, you will need to upload support content to your bsn content network in the content tab before adding it to your presentation if you are in local content mode, you will add files from your local machine files add custom files that will be published along with the presentation this feature is useful if you frequently publish files that are not used in the presentation itself (for example, a media file being played by a custom script) and you want to automate the process of publishing both presentation files and custom files name specify a name for the auxiliary file select file locate and select the auxiliary file script plugin script plugins allow you to add custom scripts to a standard brightsign author ( brightauthor\ connected) presentation without actually modifying the autorun file for example, you can use script plugins to change variable values, extract information from a txt , csv , xml , or json file to display onscreen, change the contents of a playlist, or change how the presentation responds to external input script plugins also allow you to access features that are enabled in player firmware, but haven't yet been built in brightsign author ( brightauthor\ connected) this custom functionality can be triggered by events (button press, touch, video end, etc ) or by commands, such as a zone message or udp command a script plugin can also be triggered by a plugin message command, which allows you to target the function of a specific plugin see the plugins & parsers docid\ uwsz22b8bpjf6dqq ioq2 tech note for more information on building script plugins name specify a name for the script plugin this name must match the initialization function in the plugin source locate and select the script plugin file you can find examples of plugins on the brightsign github page https //github com/brightsign/brightauthor plugins widget hide or show allows you to hide or show a ticker or clock zone by sending plugin message commands touch audio feedback plays an audio file over hdmi whenever a touch event is triggered in the presentation to retrieve a plugin from the github page, right click the raw link on the plugin page heading and click save link as parser plugin this feature allows you to add a custom brightscript snippet for parsing feeds in your presentation it can be added to states that use feeds to download and display content such as a media list docid\ qa4wytvulmrtkn30caj1y , and, like plugins, can change playlist contents or display information from a txt, csv, xml, or json file parsers are not triggered by a command or associated with an event any function that uses an event as a trigger must be written as a plugin, not a parser a parser does not need to work exclusively with the data in the associated feed once the parser starts running, you can use it to delete a file on the storage, send a udp command, or download another feed or file see plugins & parsers docid\ uwsz22b8bpjf6dqq ioq2 for more information on building parsers parser plugin name specify a name for the parser plugin file the name should be the same as the subroutine name in brightscript parser plugin source locate and select the parser plugin file feed parser enter the name of the feed parser function in the script user agent parser (optional) enter the name of the parser function for user agent strings user variable parser (optional) enter the name of the user variable parser function in the script you can find examples of parsers on the brightsign github page https //github com/brightsign/brightauthor parser scripts rss converter converts a standard rss feed into the same format as a bsn live text feed, allowing you to display rss feed items by index number in a live text state live text title and description allows you to display both the title and description of an rss item in a live text state to retrieve a plugin from the github page, right click the raw link on the plugin page heading and click save link as video mode plugin this plugin changes the video resolution, frame rate, color space and color depth brightsign offers the following video mode plugins setmultiscreensvideomode brs configures video for series 5 players see https //github com/brightsign/video mode plugin/blob/master/setmultiscreensvideomode brs https //github com/brightsign/video mode plugin/blob/master/setmultiscreensvideomode brs for more details setsinglescreenvideomode brs configures video for series 4 and below see https //github com/brightsign/video mode plugin/blob/master/setsinglescreenvideomode brs https //github com/brightsign/video mode plugin/blob/master/setsinglescreenvideomode brs for more details once you have updated the brs file with your desired screens settings, you can add it to brightsign author ( brightauthor\ connected) see video modes docid\ qpml112mbhek7lbdguxnv and multiscreen videomode docid\ bz9wxfv8mpxsfjwmtjrbd for more information about which values are valid for your player https //github com/brightsign/brightauthor plugins/tree/master/set video mode https //github com/brightsign/brightauthor plugins/tree/master/set video mode manages a plugin that sets the videomode (the videomode plugin brs option) though this method is more complicated, it is useful if you want to control the videomode in your presentation through logic driven events and commands switch presentation add supplementary presentations that will be published along with the primary presentation you can use the switch presentation command to switch to another presentation while a presentation is running presentation name specify the presentation name, which will be used in the switch to presentation command presentation source locate and select the bpfx presentation file you can also switch presentations based on a timeout event this feature is available in both local and bsn mode to do this make sure that your presentation is connected to a timeout event and save it open the switch presentation drop down by selecting the plus sign select the name with the red dot (see image 1) enter a new presentation name and presentation source under event properties > advanced , select add command (see image 2) select other in the command drop down under command parameters , either select switch to presentation and specify the new presentation name alternatively, select specify via user variable and create a new variable (under variables ) with the new presentation name as the default value enter that variable under specify via user variable save your changes you cannot successfully switch presentations between presentations with different connector types, screen resolutions and/or frame rates if you try to do this, the player will reboot and return you to the originally scheduled presentation if you have plugins, etc that reboot the player, switch presentation will also fail switch presentation does not let you switch to a presentation that has never been published this bug will be resolved in a future release data feeds add data feeds to the presentation name specify a name for the data feed url source the data feed from an rss url dynamic playlist source the data feed from a dynamic playlist docid\ gpjwf1lnjhau eqzjmfuq on your bsn content network live media feed source the data feed from a live media feed docid\ gpjwf1lnjhau eqzjmfuq on your bsn content network live data feed source the data feed from a live data feed docid\ gpjwf1lnjhau eqzjmfuq on your bsn content network parser plugin select a parser plugin docid\ a6ali6u szxhuansk6t3 to parse the feed data before it is passed to the data feed optimize feed updates (use head calls) check this box to have the player make an http head request before retrieving the contents of a data feed see the data feed section automatically generate user variables from data feed use the data feed to populate a set of user variables for html pages the user variables can then be retrieved using javascript use the \<title> tag of the data feed to specify the name of a variable and the \<description> tag to specify its default value user variable access select shared to make the user variable accessible to other presentations scheduled on the player if two presentations use a variable with the same name, the value of the variable with the shared attribute will be used for the variable with the private attribute node js select the + sign to add node js® applications to your presentation each application included here will be automatically launched when the presentation starts use webpack docid\ vlskfvzequ04pd58rvxam to reduce the number of files in your application before uploading it internal web page the internal web page allows you to view and edit user variables over your local network in order to display a standard or custom device web page, the local web server docid\ nzya n1q222tpb7iugyag must be enabled on the player disable choose this option if you would like to enable the local web server but do not want the device webpage to be accessible standard choose this option to enable the default device web page, which lists all user variables and their default/current values on a sparsely formatted page custom choose this option to use a device web page with custom appearance, formatting, and functionality see custom internal web page docid\ dipnazgdp9lzbg8drp7b6 for more information (although this note describes the legacy brightauthor, it has information that can be useful to brightsign author ( brightauthor\ connected) users) variables use the variables section to create, edit, and delete user variables user variables are customizable values that can be used in the user variable state docid\ x4ppgsmpdh1xpzpb9cqsp , as well as commands and conditional targets docid\ az1ytdteyh zp2dbg lbl the values of user variables can also be changed during a presentation using the set variable or reset variable commands creating variables click the add variable icon (the "+" icon) to add a new variable to your presentation variable name enter a unique name for the user variable default value specify an initial value for the user variable whenever a user variable is reset (via the reset variable docid\ x5qvx4z6upu5ymwg7x3ft command), it will return to this default value setting a new default value and republishing the presentation will not set the value of that variable to the new default value instead, the variable will retain whatever value it had before the publish operation to set variables to their new default values, you will need to check the reset variables to their default value on presentation start box before publishing the presentation to set a single variable to its new default value, use the reset variable docid\ x5qvx4z6upu5ymwg7x3ft command access select shared to make the user variable accessible to other presentations scheduled on the player if two presentations use a variable with the same name, the value of the variable with the shared attribute will be used for the variable with the private attribute type select a user variable type local local variables can be changed with the set variable / reset variable commands or via the device web page they can also be set with properly formatted serial, udp, and plugin message events networked networked variables are set and modified using a feed (rss, dynamic playlist, live media feed, or live data feed) note that every rss entry has a value and a value use the value to designate the name of the user variable being modified; use the value to change the value of the user variable parser plugin select a feed parser to parse the feed data before it is used to update the variable optimize feed updates (use head calls) check this box to have the player make an http head request before retrieving the contents of a feed see the data feeds docid\ a6ali6u szxhuansk6t3 section above for more details automatically generate user variables from data feed use the feed to populate a set of user variables for html pages see the data feeds docid\ a6ali6u szxhuansk6t3 section above for more details systemvariable system variables are not determined by the user, but by independent system parameters, such as firmware/autorun version number, ip address, rf channel count, and various types of edid (extended display identification data) information received from the display over hdmi note that displays will often lack a complete set of edid parameters make sure to test the edid values of a certain display model before using them in a presentation system variable this option will appear if you selected system variable under type use it to select a system variable from the drop down list see the image below connector this option will be visible if you selected an edid system variable under type if you are using a player with one hdmi output, this option will be greyed out and show only hdmi 1 if you are using a player with multiple hdmi outputs, you can use this feature to link the variable to the available hdmi outputs for that device viewing variables expand all | collapse all is useful if you have multiple variables in your presentation it allows you to easily expand or collapse all of the variables in your presentation with one click editing variables you can also configure settings that apply to all variables in the presentation alphabetize variables in app display check this box to list variables on the device web page alphabetically select the arrow next to variable name to sort the variables from a to z or z to a new variables will be added to the end of the alphabetized list and the arrow next to variable name will revert to a dash (which indicates that the list is again unsorted) automatically create media counter variables check this box to create media counters for all media files in the presentation media counters record how many times a file has played in a presentation they can be displayed in a live text state docid\ zmrkctvfwvli8u1z5frvk or user variable state docid\ x4ppgsmpdh1xpzpb9cqsp reset variables to their default value on presentation start check this box to reset all user variables to their default values whenever the presentation begins if this box is unchecked, user variable values will be preserved on the sd card after the device reboots, the presentation is switched, etc update frequency for networked variables specify how often networked user variables should be refreshed by feeds user events these event types allow you to save interactive event types and parameters, so that you can access them more readily in the future, and allows you to combine multiple interactive events into one user event for example, if you frequently use a five second timeout event , you can create a user event with this specification in the future, instead of having to set each timeout event to five seconds, you can instead use this user event or you could combine multiple transition events like button press, keyboard, touch, and gpio into a single user event to create a user event , select add event and enter a unique name use the drop down list to select an interactive event (a timeout event is shown in the image), and enter any parameters that are needed for that event type repeat this process for all of the events you want included in the user event to assign the user event to content, select the content in the center pane and assign a user event docid\ w3qup70gqxc6itrp j9vq to it you can also copy a user event using the copy icon in the top right corner when in “local” mode, user events can also be imported from other presentations, or exported to other presentations see dashboard and menus docid 8ythtvfoe83v1sssbyiw the import and export functions can be found under the edit menu interactive the interactive section allows you to configure interactive i/o for the presentation touch use this tab to configure bp200/bp900 button panels and touch screens button panel use the button panel dropdown list to select the type of button panel (bp200 or bp900) you wish to configure the a, b, and c letters specify which device is enumerated first; the b and c letters are only applicable if you are connecting more than one bp device to the player choose one of the following automatically configure which buttons are enabled only buttons that are configured with bp200/bp900 events in the presentation will be enabled all other buttons will not light up or react to button presses specify which buttons are enabled only the specified buttons will be enabled regardless of whether there are bp200/bp900 events in the presentation configured to use them if this option is selected, a bp200/bp900 event set to the any button option will only react to button numbers that have been enabled touch cursor select a mouse display option for a touch event docid\ fddoo4f6nvh3lczechpwh the default cursor setting for touch screen events is auto display cursor the cursor will be displayed if there's more than one touch region currently on the screen; if there's only one touch region on the screen, the cursor will be hidden this option does not apply to html 5 states (the cursor in html 5 states is enabled/disabled on a case by case basis in state properties > options ) always hide cursor the mouse cursor will never appear with touch events always display cursor the mouse cursor will always appear with touch events auto display cursor the mouse cursor will be present only if there is more than one touch event region on the screen flip coordinates check this box to reverse the coordinates of the touchscreen input connectors use this tab to configure serial port, gpio communication, and ir remote configuration serial port select a serial port to configure most standard serial devices enumerate on port 0 (on the ho523, they will enumerate on port 1) a usb serial device (such as a gps receiver) will enumerate on port 2 additional usb serial devices will enumerate on ports 3, 4, 5, etc the enumeration order will remain consistent between reboots as long as the usb serial devices are connected to the same player/hub ports the enumeration order can be retrieved using the "usblist" command at the brightsign> shell prompt docid\ ywksi6x 2hez1bwztfhmp ; otherwise, it will need to be determined by testing the setup gps receiver (port 2 only) check this box if the port is being used to connect a usb serial gps device to the player protocol determine whether the serial data is formatted as binary or ascii baud rate set the baud rate for serial communications on the port data bits set the number of data bits parity set the parity stop bits select the number of stop bits send eol select the end of line character when sending data to a serial device receive eol select the end of line character when receiving data from a serial device invert signals check this box to invert the tx/rx signal levels on the serial port this allows the player to communicate with devices that use 12v to 12v signaling inversion is only supported on the following ports the de9 and usb ports on the 4kx42, as well as the 3 5mm serial port on the xtx43/xdx33 (units that are rev h or earlier) and hdx23 except for the 4kx42, all of these ports perform 5v signaling gpio configuration many brightsign models feature a da15 or phoenix style gpio port for device communication and interactive input/output select input or output for each gpio button to indicate whether it should be used to receive or send information the "button" numbers are not the same as gpio "pin" numbers some pins act as power supply or ground, so they are not included in the button numbering scheme see the hardware interfaces section of the hardware manual docid\ uyyjyej6qojy1hksbrlpu associated with your player model to view a mapping of buttons to pins ir remote configuration the user can select from the events and/or commands available based on their ir in source and ir out destination selections remote control this can be either one of brightsign remotes (rc 1001 or rc 1002), or a user specified remote ir in source this configuration is one of a dedicated ir, or iguana (usb), or none ir out destination this configuration is either dedicated ir, or iguana (usb), or none networking use this tab to configure udp communications and ptp synchronization udp udp destination address specify where udp commands generated by the presentation should be sent specific ip address enter a single destination ip address in dotted quad form all devices on the local subnet broadcast udp messages to all devices on the local subnet all devices connected via ethernet broadcast udp messages to ethernet connected devices on the local subnet all devices connected via wireless broadcast udp messages to wireless networked devices on the local subnet udp destination port specify the destination port for udp messages generated by the presentation udp receiver port specify the port used by the player to receive udp messages (for triggering udp events docid\ ugicbbp6yx 8te bjdge8 on the player) udp input list this section lists all udp events in the presentation for each event, you can specify the following options label specify a label for the udp command button in the bsn mobile app by default, the command label will be the same as the udp message string show in brightsign app check this box to have the command button corresponding to the udp input event appear in the bsn mobile app player sync you should enable synchronization between players this feature passes synchronization events from leader to follower players (in video walls, for example) enable select this checkbox to put players in a synchronization domain (this domain selects a ptp address where clock and synchronization events will be published from the leader player and read by the follower player) leader makes the currently selected player a leader player follower makes the currently selected player a follower player there can be multiple follower players domain enter a domain number between 0 and 127 that is unique for each set of leader/follower presentations on the local network this will ensure that multiple groups of synchronized presentations can operate on the same local network without synchronization messages interfering with each other pdf version