Live Text State

a live text state consists of images and text fields overlaid on top of each other images can be layered with both static text and updatable rss and mrss content, and the positions and sizes of all items can be customized state properties name the name of the live text state initial state select this to make this state the home screen notes this section lets you store important information about the live text state for future users it can be modified at any time advanced this section lets you add commands to your presentation to extend its functionality see commands & conditional targets docid\ az1ytdteyh zp2dbg lbl for more information using a live text state image 20240410 231756 new\ png make sure the advanced zone type is selected (instead of simple) and drag and drop a live text state onto the canvas double click the live text widget icon on the canvas to edit the state layers image 20240430 230856 png live text items are organized by items with each item belonging to its own layer (unless you click the trashcan icon to delete an item from the live text canvas) each layer can be clicked and dragged up or down each layer has a number associated with it higher numbered layers are displayed on top of lower numbered layer for example, in image 2 above, the “os version” is layer 2 and will be displayed on top of the “fixed text example” text which is layer 1 background is a permanent layer that is always displayed behind all other live text items to set the background, click anywhere on the canvas outside of an existing item the background layer will be highlighted next, click layer properties to set the background to either a color or an image add item click the "+" icon to add a new item to the live text canvas position check this box to set an initial position for new items in relation to the most recently created item input the offset distance for the next text item (in pixels) in the left (x) and top (y) fields duplicate this enables a duplication of the currently selected item offset checking the offset option will offset the duplicated item relative to the item selected update live data refresh items that are populated from a remote url (i e live text data, rss feed, media rss feed) grid lines check this box to include invisible gridlines on the live text canvas when you manually move or resize elements by clicking and dragging them, they will snap to these lines enter the distance between gridlines (in pixels) in the vertical and horizontal fields to exit the live text canvas and go back to the zone content canvas, click either the < back button in the top right corner of the canvas, or the zone description located in the top left corner of the canvas layer properties select an item on the canvas or from the layers list to edit its properties size & position adjust the width and the height of the item as well as the position of the item on the horizontal ( x ) and vertical axes ( y ) type use the dropdown menu to select the item type fixed text displays simple, static text under text , enter the text you want to display system variable displays the player serial number, os version, script version, or other system value use the dropdown list under system variable options to determine which system value you would like to display media counter displays the number of times a media file has played in a presentation to use this feature, media counters must first be enabled in the presentation settings > variables docid\ a6ali6u szxhuansk6t3 section use the dropdown list under media options to select a media file that is being used in your presentation variable displays the current value of a variable you must create a variable docid\ a6ali6u szxhuansk6t3 before using this option use the dropdown list under variable options to specify a variable in the text field image displays an image depending on your content mode docid 8ythtvfoe83v1sssbyiw , you will be prompted to select an image file from either your bsn cloud library or your local computer live text data displays content from a feed in the text field the displayed feed item will remain fixed and will not cycle through feed items like an rss ticker (use the "rss feed" type for this functionality) however, you can still update the text in real time by modifying the feed on the server and changing the description associated with the feed item item title specify the feed item to display using the title/name of the item item index specify the feed item to display using the index number of the item validate live text data refresh the contents of the item based on the selected item title/index rss feed displays content from an rss feed display rss title check this box to display the title of the rss item display rss description check this box to display the description of the rss item mrss feed displays content from an mrss feed display media rss title check this box to display the title of the mrss item display media rss description check this box to display the description of the mrss item display media rss media check this box to display the media item associated with the mrss item brightsign author ( brightauthor\ connected) presentations cache a single media rss (mrss) feed and retain the content files until they are refreshed when displaying the mrss feed, the presentation will play files as they are downloaded if an image file takes longer than five seconds to download, the unit skips to the next image in the feed if a video file hasn't finished downloading, the unit skips to the next file until all items have been attempted data feeds use this section to add data feeds to your live text data, rss feed, and mrss feed items for rss feed and mrss feed items, you can add multiple feeds the item will cycle through the feeds according to their order in the list use the validate button to check if the feed is accessible and if the format is correct if your data feed is valid, a green message will appear to let you know that the data feed was accessed successfully if there are problems with your data feed, you may get the following messages if no data feed url is specified, you will get an error stating “data feed source not properly specified” if you select validate at this stage, you will get an error indicating that you must specify a data feed url if an incorrect data feed url has been input, you will get an error stating “unable to access specified data feed check the url or try a new one ” set text parameters use this section to edit the appearance of a text item for example, you can adjust the font size of a text widget in a live text state by choosing an automatic or fixed point font size for the text time to display each line (rss feed, mrss feed only) specify how long (in seconds) to display each entry in the feed rotation specify a degree of rotation for the text this option does not rotate the dimensions of the text box, so you'll likely need to resize it manually alignment specify whether the text is left aligned, right aligned, or centered foreground text color select a color for the text background text color check this box to include a background color for text fields font size select automatic to fit the text to the height of the text field so each text widget contains only one line of text this is the default option select fixed point size to enter a value for the font size (1 500) font select a font for the text the system font option uses the default linux font you can use any truetype font click reset to system font to reset the font to the default when selecting a font file, you cannot browse to the font files in the windows fonts folder you will need to copy the font file to your desktop or another location and then select it using the local font button in brightsign author ( brightauthor\ connected) if the presentation's destination is set to brightsign network, fonts can be accessed through the bsn cloud by navigating to set text parameters > bsn fonts examples adding a live text state to a presentation make sure that your brightsign author ( brightauthor\ connected) presentation contains a video or image zone, and that the toggle is set to interactive drag and drop the live text icon into the canvas in state properties enter a name for the live text state double click the state to edit it, and select a background image if you do not specify a background image, the text may display on top of a video, image, or the background color of the presentation (depending on the zone layering docid 0vm0utpl2j8dss dfnhmo in the presentation) add one or more live text items (fields) and adjust the settings for those fields live text states aren't available in ticker zones updating a static text field you can manually edit live text fields in brightsign author ( brightauthor\ connected) and republish, or use an rss feed or bsn cloud live data feed to remotely update live text to configure the live text state to receive updates go to content > new component > live data feed to create a bsn cloud live data feed docid\ gpjwf1lnjhau eqzjmfuq in the presentation tab, open a live text state select a text box or add one using the add item button use the type drop down list, select live text data, and go to data feed choose the data feed you created in step 1 in live data feed if you're hosting your own rss feed, enter the url in the data feed field enter an item title or item index number for the live text item the feed item (rss or live data) that matches this value will be displayed in the text box once you have configured the live text state, publish the presentation to your player displaying a udp message using a live text state follow these steps to display and update live text fields using udp messages create the required number of user variables by going to presentation settings > variables and clicking the add variable button to create each user variable then click ok variables udp png drag and drop a live text state onto an interactive playlist live text state png select user variable for the item type , then select the corresponding user variable under user variable options (“cell1” in this example) set type png click add item to add more text widgets to the live text canvas, and then assign the remaining user variables to these widgets navigate back to the interactive zone where the live text state is located three variables png drag and drop the udp event onto the live text widget from events udp event png in event properties enter "” (without the quotation marks) into the specify udp input field note text in the label field is up to the user select transition to new state under target state transition udp png in event properties select the assign input to variable option and make sure that the input specifies variable option is selected input udp png publish the presentation to the player sending udp messages you can use any application capable of sending udp messages to display your udp messages on the screen this example uses hercules http //www hw group com/products/hercules/index en html to send udp messages to the networked player(s) playing the above presentation open hercules and go to the udp tab under module ip , enter the brightsign player ip address and port 5000 (this is the default udp sender and receiver port on brightsign author ( brightauthor\ connected)) under the server settings make sure to deselect server echo , redirect to tcp server , and redirect to tcp client at the bottom under the send section enter “cell1\ new message” and click send to display “new message” on the brightsign player the string consists of "user variable\ the message" you can also use one udp string to update multiple live text items at the same time to do so, you need to separate each message with a !! for example, you can enter cell1\ my message!!cell2\ my other message!!cell3\ yet another message and click send image 20240520 232919 png if you want to broadcast a udp message to all the brightsign players on the same subnet, you can replace the ip address of the player with a broadcast address (e g , 192 168 1 255)