Common Parameters

These buttons are found top right of the Dexter editor and are not active in control mode:

• Control: See Control Parameters.

• Design: See Design Parameters.

• Text: See Text Parameters.

• Trigger: See Trigger Parameters.

• Stopper: See Stopper Parameters.

• Info: Shows the delimited borders defined by the mark settings.

• Update: Applies the changes on the already existing containers.

• Build: Rebuild all objects.

• Clear: Clear the text objects.

Control Parameters

Use the Control section to start, stop, continue and reset the scroll/roll. It also contains buttons to select the velocity mode and speed of the ticker.

• Start starts the animation.

• Stop stops the animation.

• Reset resets the animation.

• Cont continues the animation.

• Loop loops the scroller/crawl.
  The velocity control allows you to define how the speed of the crawl/roll is to be calculated.

• Duration (all groups same) makes all group use the same amount of time to crawl/scroll from start to end. The duration will be measured at the group containing the longest text string.

• Duration (for each group) makes all groups use exactly the same time. As a consequence, longer text strings will scroll faster than shorter ones.

• Speed makes all groups scroll at the same speed, as a consequence long message will take longer time to scroll than shorter messages. The speed unit is pixels per frame divided by 10.

Design Parameters

In the design section of the Dexter editor set a range of parameters to how the text will show:

• Screen width: Sets the width of the screen used for placing the text objects and culling. Possible values range from 20 to 4000.

• Screen height: Sets the height of the screen used for placing the text objects and culling.

• Loop kerning: Defines the spacing between two loops. Possible values range from 0 to 1000.

• Group kerning: Sets the vertical distance between group items.

• Crawl mode: Creates a normal horizontal scrolling text.

• Roll mode: Creates a vertical scroll.

• Default Font: Shows the default font. To load a font, drag it from the Server Panel and onto the font drop zone. To unload a font, simply drag it to the trashcan. This must be set to get any text unless you specify a font in the macro and all text are executed with macros.

• Autosplit text: If you have a long text string written in one line, without the auto-split feature, this is built as a big text object. This is not good for culling and performance. If you activate auto-split, long text objects will be split up into smaller ones which is better for performance.

• Corr. val.: Every time the auto-split feature splits a text object, the correction value is added to the gap between the two new objects. Although it reads the length of a space character from the font to make a proper placing of the objects there is a slight difference in length between a split and a non-split text. Therefore, the correction value is inserted to correct text that does not look good because of incorrect placing when the objects are split.

• Min. object length: Sets the minimum object length for an auto-split object.

• Col1: Allows you to set the default color 1. To set it, either drag a material from the Server Panel onto the col1 icon, or use the color editor below.

• Col2: Allows you to set the default color 2. To set it, either drag a material from the Server Panel onto the col1 icon, or use the color editor below.

• Col3: Allows you to set the default color 3. To set it, either drag a material from the Server Panel onto the col1 icon, or use the color editor below.

Text Parameters

The Text Editor contains the text area where you enter the script commands. It also contains a list of all tokens and parameters. By clicking on a token or parameter, you automatically insert it into the script text at cursor position.

• Space=Text: Forces the parser to interpret spaces at the beginning of a line/after a token has ended as legal text (in its default state those spaces are abandoned).

• LoadFile: Allows you to browse for a script file. The default extension for the file is .edx. The script file must contain a macro script with standard syntax. When the file loads, the contents are written onto the text field.

Trigger Parameters

• Act.: If this toggle is on, the marker will be evaluated.

• Mark: The name of the marker for orientation.

• Position: Here you can set the marker position where an event should occur.

• Command: You can type in here required Viz commands.
  The concept of marks and triggers allows you to send commands to Viz Artist/Engine when the animation reaches a certain position. To make it work you need to define two items:

First of all, mark the trigger positions in the text crawl/roll. This is done using the token <MARK>.

Animation starts<MARK A>here.

There are six marks, named A, B, C, D, E and F, that can be put wherever desired in the text. If Info is enabled, a representation of the mark will be visible on-screen.

In addition to the six user-definable marks, there are two marks that are created automatically, named BEGIN and END. They are located at the beginning and end of the crawl/roll. Please keep in mind that the END mark is located before all the containers created for the loop feature and that marks are not looped.

After setting marks and building the crawl/roll, trigger actions must be specified. All eight marks are listed in the trigger section of the editor. The on/off switch left to the mark name is used to set that mark active/inactive. The position value right to the mark name sets the position where the triggering should occur (value 0 is at the end of Dexter’s bounding box. When animation is running and the mark in the text reaches this position, the specified command is triggered. If you switch on Info you will see a line representing the trigger position. Simply switch it on and watch the marks and lines interacting to see how this works. Right to the trigger position you will find a text field where you can enter the command which should be sent to Viz Artist when a mark triggers. You may use every command available via external control, for example you may change values in Viz Artist, start animations, execute plug-ins, and so on.

First you may issue two or more commands when a mark reaches its trigger position. Simply split them using a ; character (semi-colon). Also you may use the DEXTER location to send pseudo-commands to Dexter.

Currently two such pseudo-commands are implemented: The first one is DEXTER*STOP, which stops Dexter’s animation, the second one is DEXTER*PAUSE X, where Dexter will stop the animation for X seconds (of course this is a floating point value, so DEXTER*PAUSE 0.5 is also possible) and continue with the same speed as before.

Stopper Parameters

• Enable: If this toggle is on, the markers will be evaluated.

• Use Mark: If this toggle is switched to on the given positions will be used.

• Position: Sets the position of the Ease-Out and Ease-In range.

• Ease Out: The text object is leaving this position during the movement.

• Continue: This parameter has two options. Wait for Cont and Wait Nr Fields. In first case the text object waits until an continue Viz command is being sent. In second case the text object waits for the number of fields. Consider that two fields comply one frame.

• Ease In: The text object slows down and waits for a continue signal or until the number of fields are reached.

• Global: Stops global or local to a certain group.
  The Stopper is an extension to the triggering ability of Dexter. It allows you to create ease in/out animations at defined points along the crawl/roll.First you need to create a set of marks using the <MARK> token to define the stop points in your text. Then open the Stopper page in the Dexter editor and check the Enable button.

Select which marks to use. If you have defined your stop points using the <MARK C> token you need to select C here. If you enable Info you will see a representation of the animation curve in the editor. Using the position, ease in and ease out slider you can move and alter that animation like you need. (Please keep in mind that the ease out part of the animation is executed before the ease in part: although usually it is the other way round. But here we do not want to start an animation smoothly and then stop it, we want to stop it first and then restart it again).

Using the continue switch you can select what Dexter should do after the animation has stopped: Either wait a certain number of fields or wait until the Continue button in the Control section is pressed. If you have more than one group in crawl mode you may want to check the Global as well. If it is checked, all groups will be halted as soon as a marker in any group reaches the stopper position. If it is unchecked only the group that contains this marker is stopped.

Dexter Parameters

Boolean values can either be 1 (on) or 0 (off). Color values are 4 byte unsigned integers, byte 0 = red, 1 = green, 2 = blue, 3 = alpha.

Script Programming Parameters

Color values are described in the form r/g/b/a with decimal numbers (base 10). Col1 is also used as the default color value (Material is initialized with this value). Material can also hold an existing material in the material pool, e.g. “Vizrt/Artdeco/artdeco.0” (see Col1, Col2, Col3 in Script Programming Parameters).

Detail can have one of the following values: 1, 2, 3, 4, 5, 6 or T. 1 through 6 are detail levels, T means texture font. Every other value (like the default “Auto” will be interpreted as detail level auto) (see Detail in Script Programming Parameters).

Script Programming Tokens

The ADD token adds either a string or a float to one. If either Parameter or Value are strings, the two strings can be combined to one. If both are floats, an arithmetic addition will be done.

For example:

results in “Vizrt”, but:

results in Test holding the value 11.3.

The CONTAINER token is used to define a container path for inserting a container into the text. A container path may either look like “1/3/2/3/1” (the same system as used in the GUI), “$Containername” or “#Containernumber”.

The MARK token sets a mark that can be A, B, C, D, E or F.

The GROUP token begins a new group of containers. Instead of writing <GROUP> you may leave one line empty as this has the same effect. Use groups for making lines in roll mode.

Script Programming Syntax

The syntax consists of tokens and text. <tokens> are surrounded by <>, e.g. <ENDMAC>. Spaces are used to separate tokens and arguments. Text is everything that is not bracketed. Tokens can be everywhere in the text, e.g. Viz is <SET Material 234/34/58/114>great is valid. You do not need to write every token in a new line. Nested tokens are not allowed. A macro cannot execute itself.

In addition to the tokens, there is the escape character $:

• $Parameter inserts the value of Parameter in the text

• $_ inserts a space character in the text (for use in tokens)

• $< inserts a < character

• $> inserts a > character

• $$ inserts a $ character
  The $ character can be placed in tokens and in the text, e.g. $<Dexter$> says:

Inside tokens you may use double quote characters to insert text.

Any $ characters and spaces within two double quote characters are ignored from parsing and executing. Two double quote characters are interpreted as one:

Script Programming Templates

You can define templates for the creation of text objects. Under the Dexter container you will find a container named “Templates”. Under this container you can create a set of template containers. These can hold animations, plug-ins, key, alpha, etc. Give every template container a unique name. To access it in the script, you need to set the Template parameter to the name of the template you want to use:

After you set the Template parameter, Dexter will use this template container as basis for every text object. To switch this behavior off set Template to its default value (which is ""):

Script Programming Newline Logic

The token <NEWLINE> (see Script Programming Tokens) describes a new text object, which is separated from the previous one. Every newline moves AnchorX (see AnchorX, AnchorY, AnchorZ in Script Programming Parameters) a bit further, depending on the value of Step. This token will be inserted internally to prevent you from typing <NEWLINE> over and over again.

The following text

is converted to

No newlines:

• From the beginning of the script until the first occurrence of text

• After a line that doesn’t contain text (if the line is empty a new group will be created)

• After the tokens MACRO, ENDMAC and NOTEXT, and the last newline before those tokens will be deleted
  For example:

The macro SetDir in the example above can be used as follows without creating a newline:

The same rules applies to automatically inserted GROUP tokens (see Script Programming Tokens).

Script Programming Triggers

The concept of marks and triggers allows you to send commands to Viz Artist/Engine when the animation reaches a certain position. Therefore you need to define two items:

• First is setting a mark in the text. You have six different marks to place wherever you think they are useful, together with the automatically created BEGIN and END mark this gives you a total of eight marks.

• The second items are the triggers, where you have as well eight different triggers. While marks are set with a token in the text, triggers can be defined in the trigger section of the Dexter editor or using external control. You can define a position and a command for every trigger. When the corresponding mark reaches the trigger position, the command is issued to Viz Artist/Engine.

  Note: Only marks and triggers of the same type work together! If for example mark B reaches the position of trigger D, nothing will happen.

  Marks are set using the MARK token, for example: Animation starts exactly{{<MARK D>}}here!

User defined marks are numbered A through F and are color coded in the trigger editor and as graphical symbols when show area is turned on. In addition to the user defined marks there are the automatically created marks BEGIN and END, which are inserted at the beginning and ending of the crawl/roll. The commands being issued do not have to be numbered, this is optional. If you do not give them a number, -1 is added before the command is sent to Viz Artist/Engine. you can as well define more than one command, separate them by a semicolon character.

You may invoke two internal commands using the trigger function with the DEXTER* location: stop and pause.