...
A Live Text state consists of images and text fields overlaid on top of each other. You Images can layer be layered with both static text and updatable RSS and MRSS content with images , and customize the position/size of items in relation to the background. Double click a the positions and sizes of all items can be customized.
...
Make sure the toggle switch for an Interactive presentation is on 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.
...
Add Item: Click the 
icon to add a new item to the Live Text canvas.
Layers: Click and drag a Live Text item to move it up or down the display order. Items that are higher on the list are displayed on top of lower items.
...
Layers
Live Text items are organized by items with each item belonging to its own layer. Each layer can be clicked-and-dragged up or down.
| Note |
|---|
Each layer has a number associated with them (see screenshot). Higher numbered layers are displayed on top of lower numbered layer. For example, in the screenshot above, the “OS Version” is layer 2 and will be displayed on top of the “Fixed Text Example” text which is layer 1. |
Background
This 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.
Delete Item
...
Click the trashcan icon to delete an item from the Live Text canvas.
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.
...
| Noteinfo |
|---|
To exit the Live Text canvas and go back to the Zone Content canvas, click either:
|
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 section. Use the dropdown list under Media Options to select a media file that is being used in your presentation.
User Variable:
...
Displays the current value of a User Variable. You must create a User Variable before using this option. Use the dropdown list under User Variable Options to specify a User Variable in the text field.
Image: Displays an image. Depending on your Storage Selector setting, you will prompted to select an image file from either your BSN.cloud library or local machine.
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.
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.
...
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.
If you create a large, complex interactive playlist, you will likely run into two problems: You’ll find yourself having to create a large number of redundant events, and it will become difficult to keep track of numerous branching states and conditions. Super States are implemented to alleviate these problems and make complex interactive presentations manageable.
| Note |
|---|
When the Super State icon is double-clicked, the Super State canvas will appear. The Super State canvas gives you the option to add media states from Widgets to the Super State. To exit this canvas, click the Zone description located in the top left corner of the canvas. This will take you back to the Zone Content canvas. |
The primary mechanic of the Super State is that it functions as both a state and a self-contained interactive playlist. A Super State can be transitioned into and out of using any event, but double-clicking it will reveal a new interactive playlist canvas contained within the original. There are several behaviors that are unique to this state:
...
Each Super State contains a Home State: A transition to a Super State will point to the initial state within the Super State by default. However, you can point the transition to any other state within the Super State by opening the event and selecting the desired state from the Specify next state dropdown menu.
...
Super States can be nested inside other Super States: You can use the breadcrumb trail above the playlist area to keep track of where you are within the hierarchy of Super States.
...
Super States can have Entry and Exit Commands: Entry Commands are triggered when any state within the Super State is transitioned to. If a Super State is contained within one or more other Super States, a transition to or from that Super State will trigger Entry/Exit commands on all other Super States that will need to be moved through for the transition to reach its destination. Commands will be executed in sequential order, depending on whether the transition is ascending or descending through a hierarchy of Super States.
...
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 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.
How to Add a Live Text State to a Presentation
Make sure that your 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 layering of other zones 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.
How to Update a Static Text Field
...
You can manually edit Live Text fields in 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.
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.
How to display 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.
...
| Info |
|---|
Note: In this example, three dots are used for the Default Value, but any value is acceptable. |
Drag and drop a Live Text state onto an interactive playlist.
...
Select User variable for the item Type, then select the corresponding User Variable under User Variable Options (“cell1” in this example).
...
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.
...
Drag and drop the UDP event onto the Live Text widget from Events.
...
In Event Properties enter "<any>” (without the quotation marks) into the Specify UDP input field.
| Info |
|---|
Note: Text in the Label field is up to the user. |
Select Transition to new state under Target State.
...
In Event Properties select the Assign input to variable option and make sure that the Input specifies variable option is selected.
...
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 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 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.
...
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 such as “192.168.1.255”.