Text Input Editor

Navigation:  Pandoras Box > User Interface - Master > Tabs Overview >

Text Input Editor

prev main next

Navigation:  Pandoras Box > User Interface - Master > Tabs Overview >

Text Input Editor

prev main next


Click to enlargeCreate your Text Input by right-clicking on a folder in the Project tab > Add Text Input. Select it to see its properties in the Text Inspector. It also offers the button "Open in Resource Editor" which opens the tab "Text Input Editor". Alternatively, you can click on 'Tabs' in the Toolbar > Text Input Editor.

In the Text Input Editor you may set up all options regarding the content of the selected Text Input. It also allows to transfer style properties to other Text Inputs.

Please note, that .net framework 4.0 is needed to display this tab.


At the top of the depicted Editor you see in the drop-down list that only one Resource named "MyText." is selected. If multiple Text Inputs were selected, the section "Behavior / Texture" applies to all of them.
Afterwards, it is displayed, that the according Text Input is assigned to the first Video Layer of the second Site and that the Playback command (from the Layer) is set to Play Loop. The playback is needed when the Text Mode is set to Scrolling or Streaming and the container is changed from Lock To Time to free run mode. If the container is locked to time, and the sequence is playing, the text will "play", i.e. move also. Mind that playing back is only possible on Video Layers. If you would like to use scrolling text on another Layer, please use the Aeon FX "UV Scroll".


- Mode
Your text is displayed on a fixed position according to the Layer's Position parameters.
--Scrolling and Streaming
Your text will move according to the following parameters.
For the Scrolling Mode, you enter text, click "Update" and instantly the entire text will be displayed as scrolling text. Depending on the playback mode, the text will scroll once or endlessly. The old text will be kept in the Editor window. If you would like to show new text, enter it and press "Update". In case, your text is scrolling endlessly (Play Loop) the old text will change abruptly to the new one.
For the Streaming Mode, you enter text, click "Commit" and after a couple of seconds, your entire text will scroll once through the window. Note, that it cannot scroll endlessly. The old text will be deleted from the Editor window. As soon as you enter new text and click "Commit", it stands in a pending line. Only when the old text has moved out of the window, the new one can be displayed. This means on the one hand that you can commit unlimited text entries and PB takes care, that one follows the other. This is done by rendering multiple textures at the same time. Which also means on the other hand, that textures can be empty if now pending text is available. This explains why you have to wait for the duration of one texture width / height before recently committed text becomes visible. If you would like to clear pending text click the "Pending" button underneath the Editor; to clear pending text and the one currently displayed, click "All".

Please note that Widget Designer can send text to a Pandoras Box Text Input regardless from its mode. You can use the Text Input control or the PB Text Output node.

- Base Speed
Enter the speed for Scrolling and Streaming text. It is measured in pixel per second. When entering negative numbers the direction will be reversed.

- Direction
Choose how Scrolling and Streaming text should move: "Horizontal" for right-left movement and "Vertical" for down-up. Note that the direction can be reversed with a negative Base Speed.

Loop Offset
Influence whether Scrolling and Streaming text should have an offset, i.e. blank space before the start of a new text entry.

Start with Blank
Decide whether Scrolling text should start with blank space before its first letter. Use the option "Offset

BG Color / Alpha
Choose a background color (for all text modes) and its opacity (0 = transparent)

Width / Height
Set up how large the texture for a text entry should be. Note that this influences the Base Speed and Font Size. The larger the Font Size the smoother font edges look and the larger the texture needs to be.

Center Text
This centers Static Text vertically.

text-input-editor_icons_07 Enter your text into the Editor. If you have chosen a Static or Scrolling text, click "Update" to display your changes. In case you are working with a Streaming text, click "Commit". See above explanation for further detail.
Undo your last steps or Redo undone ones.
Cut or Copy selected text and Insert it with the last button. The shortcut [Ctrl + A] selects all text in the Editor.

"Word Wrap in Editor" creates a new line if your text is longer than one line in the Editor.

Choose a Font and the Font Size for selected text. Note that the Font Size also depends on the texture width/height.
Choose a Font Style for selected text: Bold, Italic, Underlined, Strike through, Font Color (opens a Color dialog)
 Align Left, Align Center and Align Right are used to position your text in regards to the texture width.
The last button
opens the "Transfer Text Properties dialog".

In case you have selected multiple Text Inputs in the Project tab, you can choose with the drop-down list (at the very top) which text is the "master" or "source".
Per default, all "Text" options apply only to the master text. With this dialog however, you can choose to transfer the current options to all other selected Text Inputs too. In case you have set up more than one style in your master text, only the first one can be transferred.

Select which property you would like to copy and press "Ok".

If you would like to create multiple copies of your current Text Input, please right-click on it in the Project tab and choose "Clone".