Text-based objects are static text, marquee and roll. They have common transformation, content and general parameters.

Text

New_Text_Object.png

A text object is used for different kinds of text fields in a fixed position. To add this object, select it from the "Insert" main menu; alternatively select it from the "Insert" drop-down list of the tree context menu.

The text for the object can be specified in the "Text" field:

geometry_tab_text_styles

You can add variables to the text by linking a previously created variable. For this type in the $ symbol, the list of all available variables appears:

text_variable_autocomplete

Double-click the required variable, it will be added to the text and highlighted:

text_variable_autocompleted

Font

In the "Font" configuration group you can specify the formatting parameters, such as font family, size, font style (bold and/or italic).

Note
Please ensure that the custom set of fonts is installed on both working and playout stations.

Select the "Word Wrap" checkbox to split long text into lines inside the text object box on the canvas without actual line breaks.

Select the "Right to Left" checkbox to enable the right-to-left languages writing style.

The "Vertical Direction" option enables the vertical orientation of the text in a line.

Select the "Subpixel Align" checkbox to enable the alignment with sub-pixel accuracy.

The "Horizontal Align" and "Vertical Align" parameters define the alignment of the text within the text object boundaries. The values are represented with the corresponding icons.

The "Default Graphics Size" parameter defines the default insertion mode for the graphic objects inserted into the text. Use the drop-down list to choose between "Upper case" to fit the graphic object to uppercase letter size; "Lower case" to fit to lowercase letter size and "Font size" to fit to full font size:

Letter size

Spacing

The "Spacing" configuration group contains parameters for defining spacing behavior between text characters, words and lines of text within the text object boundaries.

The results of these changes will be visible in real-time within the canvas area.

Marquee / Roll

New_Marquee_Object

The marquee object is most commonly used to create news tickers allowing the text to move from right to left on the screen. To add it to your scene, select it in the "Insert" main menu; alternatively select it from the "Insert" drop-down list of the tree context menu.

New_Roll_Object

The roll object is similar to the marquee, except that the text slides from top to bottom or vice versa. To add it to your scene, select it in the "Insert" main menu; alternatively select it from the "Insert" drop-down list of the tree context menu.

Specify the text for the marquee / roll object in the "Text" field.

Note
Refer to previous paragraph to learn more about text formatting.

Animation

Go to the "Animation" section to specify the marquee / roll movement parameters.

Effect_Marquee_parameters

Modes of Movement

There are two animation modes for the marquee / roll object – movement by percentage value (progress), and movement by absolute speed.

Progress

The "Progress" field defines percentage of progression of the text through the complete scrolling animation at any given point.

At the start point the marquee / roll value is 0% which means that no portion of the text is visible on this initial frame. When you scroll through the timeline, you will notice that the value of this field is increasing before reaching 100% at the final frame. This means that for the final frame the text scrolling has been completed and its last trailing character has been moved from view.

No matter how long the text value entered into the object is, the animation will complete within the specified time. However, this can result in text that moves at a rate that is unsuitable.

There is a dedicated "Progress" track for the marquee / roll object on the timeline. When the "Progress" parameter is animated, the corresponding keyframes are displayed on the "Progress" track.

Marquee_value
Speed

The "Speed" value specifies the speed of the characters movement in pixels per frame.

If the "Use Speed" option is selected, the characters move with the speed defined in the "Speed" field, and the "Progress" parameter is ignored. This is a great way to be sure that text will move at a readable rate, although consideration of the overall display duration must now be given.

Play Mode

It is possible to make text scrolling follow a loop or ping-pong playback path. To do this, select the corresponding playback mode (Loop or Ping Pong) from the "Play Mode" drop-down list and specify the number of repetitions in the "Loop Count" field. To play the marquee / roll just one time, set the "Play Mode" to play once. These operations only have an effect when working with the "Speed" mode of movement.

Free Run

"Free Run" feature relates to the global loop. Let us consider its effect by an example.

Suppose you have a very long text for the marquee object. In order not to make a very long duration for the object, you can use the following trick: create a global loop at the end of the object duration and set it to loop infinite number of times.

Free_Run_Loop

As a result, the marquee text will play until the beginning of the loop, and if the "Free Run" option is enabled, the text will continue to slide continuously until stopped manually. If this option is not enabled, the text will constantly jump back to the position of the first loop frame, or in ping-pong mode run backwards.

Leave Loop on End

This option is useful when used together with "Free Run" feature.

When you use the previously described trick, with the "Leave loop on end" option enabled the marquee will leave the loop automatically as soon as its text ends and play until its end.

Image Insertion

An image can be inserted into a text object of any type: static text, marquee, roll. This can be done in several ways.

Insert Command

In the "Text" field place the cursor to the location where you would like to put the image and choose the "Insert" > "Image…​" context menu command:

Adding macro menu

The dialog box appears allowing you to select a desired graphic file. Once it is selected, press "Open" to insert an image to the text:

Added macro
Note
The size of the image being inserted depends on the "Default Graphics Size" parameter settings.

The inserted image can be removed or changed using the corresponding command from the menu invoked when the mouse cursor is within the highlighted image file path and the right mouse button is pressed.

Image_in_text_commands

Using a Tag

Another way to insert an image to the text is using a tag referencing to the graphic file. Once you type in the [ symbol via a keyboard, you will be prompted to choose a fitting mode for the image being inserted:

Adding tag suggestion

Or simply use a keyboard to enter a tag with a reference to the graphic file in the following way:

[img c:\picture.png] - to fit the inserted image to the "Default Graphics Size" parameter settings;

[imgfull c:\picture.png] - to fit the inserted image to full font size;

[imgup c:\picture.png] - to fit the inserted image to uppercase letter size;

[imglow c:\picture.png] - to fit the inserted image to lowercase letter size.

Using a Variable

You can add a graphic file to the text by linking a variable of the "File" type. Once the variable with an image file is created, you can place it directly to the text via the "Insert" > "${Variable_name}" drop-down menu command:

Insert variable

Alternatively, use a keyboard to insert variable to the text. Once you type in the $ symbol, the list of available variables appears allowing you to choose the required one:

Insert variable via keyboard
Note
The size of the image being inserted depends on the "Default Graphics Size" parameter settings.