User’s Guide Viz Ticker3D Product Version 2.4 November 26, 2013

User’s Guide Viz Ticker3D Product Version 2.4 November 26, 2013
Viz Ticker3D
User’s Guide
Product Version 2.4
November 26, 2013
Copyright © 2013 Vizrt. All rights reserved.
No part of this software, documentation or publication may be reproduced,
transcribed, stored in a retrieval system, translated into any language, computer
language, or transmitted in any form or by any means, electronically,
mechanically, magnetically, optically, chemically, photocopied, manually, or
otherwise, without prior written permission from Vizrt.
Vizrt specifically retains title to all Vizrt software. This software is supplied under
a license agreement and may only be installed, used or copied in accordance to
that agreement.
Disclaimer
Vizrt provides this publication “as is” without warranty of any kind, either
expressed or implied.
This publication may contain technical inaccuracies or typographical errors. While
every precaution has been taken in the preparation of this document to ensure
that it contains accurate and up-to-date information, the publisher and author
assume no responsibility for errors or omissions. Nor is any liability assumed for
damages resulting from the use of the information contained in this document.
Vizrt’s policy is one of continual development, so the content of this document is
periodically subject to be modified without notice. These changes will be
incorporated in new editions of the publication. Vizrt may make improvements
and/or changes in the product(s) and/or the program(s) described in this
publication at any time.
Vizrt may have patents or pending patent applications covering subject matters in
this document. The furnishing of this document does not give you any license to
these patents.
Technical Support
For technical support and the latest news of upgrades, documentation, and
related products, visit the Vizrt web site at www.vizrt.com.
Last Updated
November 26, 2013
© Copyright Vizrt 2013
Contents
1
Introduction .............................................................................................. 1
1.1
1.1.1
Document Structure ........................................................................................... 1
1.1.2
Related Documents ............................................................................................ 2
1.1.3
Conventions ....................................................................................................... 2
1.2
2
2.1
System Components ...................................................................................3
Viz Ticker Wizard ............................................................................................... 3
2.1.2
Viz Ticker Client ................................................................................................ 3
2.1.3
Viz Ticker Feed .................................................................................................. 4
2.1.4
Viz Playlist Synchronizer .................................................................................... 4
2.1.5
Ticker Service .................................................................................................... 4
2.2
System Workflow ........................................................................................4
Installing Viz Ticker3D .............................................................................. 5
3.1
3.1.1
3.2
3.3
3.3.1
3.4
3.4.1
4
Contact Information ...................................................................................2
About Viz Ticker3D ................................................................................... 3
2.1.1
3
About the Document ..................................................................................1
Important Before Installation ......................................................................5
Viz Ticker Feed Upgrade Issues .......................................................................... 5
Program Starting Sequence .........................................................................5
Installing Viz Ticker Wizard ........................................................................6
Viz Ticker Wizard Startup Parameters ................................................................. 9
Installing Viz Ticker Client ..........................................................................9
Viz Ticker Client Startup Parameters ................................................................ 12
Viz Ticker Wizard .................................................................................... 14
4.1
Starting Up ...............................................................................................14
4.2
Main Window ............................................................................................14
4.4
Main Panel ................................................................................................15
4.3
Main Menu ...............................................................................................15
4.4.1
Viz Engine Connection Frame ........................................................................... 16
4.4.2
Wizards Frame ................................................................................................. 19
4.4.3
Scene Scan Log Frame ...................................................................................... 19
4.5
Ticker Carousels Panel .............................................................................20
4.5.1
Existing Carousels List ..................................................................................... 21
4.5.2
Carousel Details Frame .................................................................................... 21
4.6
4.6.1
4.6.2
4.7
Output Channels Panel .............................................................................26
Existing Output Channels List .......................................................................... 26
Output Channel Details Frame ......................................................................... 27
GPI Panel ..................................................................................................28
4.7.1
Existing GPI Handlers List ................................................................................ 28
4.7.2
GPI Settings Frame ........................................................................................... 29
4.7.3
4.8
Show in Main Control Frame ............................................................................ 32
4.8.2
Enable/Disable Features Frame ........................................................................ 33
Button Groups and Buttons List ........................................................................ 35
4.9.2
Button Group/Button Details Frame ................................................................. 36
Scrolling Carousel Wizard ................................................................................ 38
4.10.2
Flipping Carousel Wizard ................................................................................. 43
4.10.3
Reimport Templates Wizard ............................................................................. 45
4.10.4
Output Channel Wizard .................................................................................... 46
Viz Ticker Client...................................................................................... 47
5.1
5.2
5.3
Starting Up ...............................................................................................47
Logging In ....................................................................................................... 47
Main Menu ...............................................................................................49
Control Panel ...........................................................................................49
5.3.1
Actions Frame .................................................................................................. 50
5.3.2
Handler Settings Frame .................................................................................... 51
5.3.3
Data Frame ...................................................................................................... 52
5.4
Carousel Specific Panel .............................................................................53
5.4.1
Pool Frame ....................................................................................................... 54
5.4.2
Carousel Frame ................................................................................................ 57
5.4.3
Buttons Frame ................................................................................................. 62
5.4.4
Elements Editor ................................................................................................ 62
5.4.5
Groups and Sections ........................................................................................ 68
5.5
Configuration Panel ..................................................................................69
Ticker Specific Plug-ins ........................................................................... 71
6.1
6.2
6.2.1
6.3
Installing the Ticker Specific Plug-ins .......................................................71
Scroller Plug-In ........................................................................................71
Scroller Plug-in Editor ...................................................................................... 72
Scroller Action Plug-In .............................................................................73
6.3.1
Scroller Action Plug-in Editor ........................................................................... 73
6.3.2
Controlling Progression Using the Scroller Action Plug-In ................................ 74
6.4
Toggle Plug-In .........................................................................................76
Design Conventions ................................................................................ 77
7.1
7.2
7.3
7.3.1
8
Wizards ....................................................................................................38
4.10.1
5.1.1
7
Buttons Panel ...........................................................................................34
4.9.1
4.10
6
Settings Panel ...........................................................................................32
4.8.1
4.9
5
GPI List ............................................................................................................ 31
Global Conventions ..................................................................................77
Scrolling Carousel Conventions ................................................................77
Flipping Carousel Conventions .................................................................78
Logo Animations as Flipping Carousels ............................................................ 78
Importing Ticker Example Scenes ............................................................ 79
8.1
Importing Viz Artist 2 Example Scenes .....................................................79
8.2
9
Importing Viz Artist 3 Example Scenes .....................................................80
Creating a Scrolling Carousel................................................................... 81
9.1
Creating a Scrolling Carousel Scene in Viz Artist .......................................81
9.1.1
Getting Started ................................................................................................ 81
9.1.2
Adding a Background ....................................................................................... 82
9.1.3
Stopping, Starting, and Clearing the Carousel .................................................. 87
9.1.4
Adding a Template ........................................................................................... 89
9.1.5
Saving the Scene .............................................................................................. 92
9.2
Setting Up a Scrolling Carousel in Viz Ticker3D ........................................93
9.2.1
Setting Up the System ...................................................................................... 93
9.2.2
Setting Up a Scrolling Carousel in Viz Ticker Wizard ......................................... 93
9.2.3
Using a Scrolling Carousel in Viz Ticker Client ................................................. 94
9.2.4
Optional Scrolling Carousel Setup in Viz Ticker3D ............................................ 96
10 Creating a Flipping Carousel ................................................................... 98
10.1
Creating a Flipping Carousel Background Scene in Viz Artist 2 .................98
10.3
Setting Up a Flipping Carousel in Viz Ticker3D .......................................107
10.2
10.4
Creating a Flipping Carousel Template Scene in Viz Artist 2 ...................103
Creating Flipping Carousel Messages in Viz Ticker Client .......................109
11 Viz Ticker Feed...................................................................................... 111
11.1
11.2
Getting Started .......................................................................................111
System Configuration .............................................................................117
11.2.1
Media Sequencer Hostname ........................................................................... 117
11.2.2
Source ........................................................................................................... 117
11.2.3
Transformation .............................................................................................. 118
11.2.4
Log Level ....................................................................................................... 119
11.3
XML Data Structure .................................................................................119
11.3.1
XML Example ................................................................................................. 120
11.3.2
XML DTD ....................................................................................................... 120
11.4
Viz Ticker Feed Troubleshooting ............................................................127
12 Viz Playlist Synchronizer........................................................................ 128
12.1
Synchronizing Information .....................................................................128
12.3
Main Window ..........................................................................................130
12.2
12.4
Setting up a Synchronous Environment ...................................................128
Synchronizing when Live Indicator is Enabled .........................................131
13 Ticker Service ........................................................................................ 133
13.1
Ticker Service Options ............................................................................134
14 Presentation Files .................................................................................. 135
15 Keyboard Shortcuts ............................................................................... 137
16 Troubleshooting.................................................................................... 139
16.1
System Does Not Detect Scroller Plug-In in Scene ...................................139
16.2
Not Possible to Scan New Scene ..............................................................139
16.4
Scrolling Carousel Messages Not on Air ..................................................140
16.3
16.5
Change Scene Name in Viz Ticker3D ......................................................140
Message Spell Checking not Possible ......................................................140
1
Introduction
This is the user’s guide for Viz Ticker3D version 2.4.
This chapter contains information on the following topics:
• About the Document
• Contact Information
See Also
• About Viz Ticker3D
1.1
About the Document
This Viz Ticker3D User’s Guide covers the information needed in order to
configure and operate Viz Ticker3D. The document is up to date with the latest
features available in Viz Ticker3D 2.4.
This section contains information on the following topics:
• Document Structure
• Related Documents
• Conventions
1.1.1
Document Structure
This document is divided into two major parts; chapters 1-7 and 11-14 constitute
the manual, while chapters 8-10 constitute the tutorial.
The first chapters of this document give an introduction to Viz Ticker3D.
Viz Ticker3D consists of two applications; one wizard and one client application.
Chapter 3 describes how to install the system. Chapter 4 describes the user
interface and how to work with Viz Ticker Wizard, while chapter 5 describes Viz
Ticker Client.
Chapter 6 explains the three ticker specific plug-ins, and chapter 7 design
conventions that must be followed when creating ticker scenes.
Chapter 8 shows how to import ticker example scenes. Chapters 9 and 10 give
step-by-step instructions on the whole ticker creation process; from the creation
of scenes in Viz Artist, through configuration in Viz Ticker Wizard, and all the way
to playout in Viz Ticker Client. Chapter 9 explains how to create a scrolling
carousel, while chapter 10 explains how to create a flipping carousel.
Chapter 11 describes the Viz Ticker Feed application, chapter 12 the Viz Playlist
Synchronizer, and chapter 13 the Ticker Service.
Chapter 14 explains how to create presentation files in Viz Template Wizard.
Chapter 1: Introduction
1
Chapter 15 lists the available system keyboard shortcuts, and chapter 16 answers
frequently asked questions.
1.1.2
Related Documents
For complementary information, see the following documents:
• The Viz Artist User’s Guide contains information about how to create scenes
and details about plug-ins.
• The Viz Template Wizard User’s Guide contains information on how to operate
the application that creates presentation files.
• The Transition Logic Tutorial explains the rules of the GOTO_TRIO director
used for Scroller Action Plug-In design.
1.1.3
Conventions
The following typographic conventions are used in this document:
• Italic is used for external references, such as related documents, books, or
internet pages. Italic is also used to emphasize words.
• The color blue is used for internal references to sections or document
elements (such as tables or figures) in the current document.
• Bold refers to GUI components.
1. Numbered paragraphs are used to indicate tasks that need to be carried out.
1.2
Contact Information
We encourage your suggestions and feedback regarding the products and this
documentation. Our support e-mail address is support@vizrt.com. You are also
welcome to use the web-based support at www.vizrt.com, or to contact your local
Vizrt support person by telephone.
2
Chapter 1: Introduction
2
About Viz Ticker3D
Viz Ticker3D is an advanced ticker system that makes it possible to build creative
and compelling graphic tickers with total flexibility. The system supports multiple
clients for content insertion and control. Input can be manually entered, or
automatically generated from various feeds; for example news feeds, databases,
or the Internet.
With Viz Ticker3D, multiple graphical elements with various speed can be
displayed simultaneously. The elements can include animated text, images, and
so on. The real-time aspect of Viz Ticker3D takes the elements directly, with no
delay, from content editing to air.
Viz Ticker3D has features that are not usually included in ticker products. One
feature is that ticker elements can trigger events when entering a scrolling ticker.
An event may for example be the start of an animation, or the display of predefined text or graphic objects positioned anywhere on the screen. Stock price
movements can generate up or down markers, voting results can render 3D
charts, and so on. Another feature is that the system has multi-render support
and can be set up to feed several multiple output channels from one message
carousel. Multiple clients can control a shared ticker message pool, as well as
performing on-air control.
This chapter contains information on the following topics:
• System Components
• System Workflow
2.1
System Components
Various components make up the Viz Ticker3D system:
•
•
•
•
•
2.1.1
Viz Ticker Wizard
Viz Ticker Client
Viz Ticker Feed
Viz Playlist Synchronizer
Ticker Service
Viz Ticker Wizard
Viz Ticker Wizard is Vizrt’s ticker configuration application. In this system,
carousels are selected and equipped with templates. Adjustments of the GUI
settings in Viz Ticker Client can also be defined from this system. The typical user
of Viz Ticker Wizard is a graphical artist.
2.1.2
Viz Ticker Client
Viz Ticker Client is Vizrt’s ticker client application. In this system, messages are
created, added to a carousel, and sent to air. The typical user of Viz Ticker Client
is a journalist or operator.
Chapter 2: About Viz Ticker3D
3
2.1.3
Viz Ticker Feed
Viz Ticker Feed makes it possible to populate a scrolling or flipping carousel with
data elements from a file that is being updated from an external source. It is
optional to include this component in the Viz Ticker3D setup.
2.1.4
Viz Playlist Synchronizer
Viz Playlist Synchronizer is an application that synchronizes elements of specified
ticker carousels on two Media Sequencers, one live and one backup. This makes it
possible to do a failover to the backup environment if the live machine should fail.
It is optional to include this component in the Viz Ticker3D setup.
2.1.5
Ticker Service
Ticker Service is a component responsible for communicating ticker messages to
the renderer. This component is necessary in order to run a scrolling carousel in
Viz Ticker3D.
2.2
System Workflow
The ticker creation workflow typically starts with the design of a scene in Viz
Artist. The ticker can have almost any given design, except for a few Design
Conventions that must be followed to make the ticker work properly.
The next step in the ticker creation workflow is to scan the scene in Viz Ticker
Wizard. The scanning process verifies the scene structure. After the scanning, the
logic for the ticker can be built. This is done by performing a few quick
configuration steps in Viz Ticker Wizard.
The final step in the ticker creation workflow is to launch Viz Ticker Client. In this
application, messages can be created and added to the carousel. When the
desired messages have been added, the ticker is ready to go on air.
4
Chapter 2: About Viz Ticker3D
3
Installing Viz Ticker3D
Viz Ticker3D comes with an installer that helps to setup the system.
This chapter contains information on the following topics:
•
•
•
•
3.1
Important Before Installation
Program Starting Sequence
Installing Viz Ticker Wizard
Installing Viz Ticker Client
Important Before Installation
• If Viz Ticker Wizard or Viz Ticker Client, or both, are already installed on the
machine, first remove the old program versions before installing the new
ones, see Installing Viz Ticker Wizard and Installing Viz Ticker Client.
• In addition to Viz Ticker Wizard and Viz Ticker Client, the following
applications must be installed in order for the ticker system to work properly:
Tip: It is recommended to use the latest available version of each product.
•
•
•
•
Media Sequencer (version 1.21 or above)
Viz Artist/Viz Engine (version 2.8 or above)
Extra Viz Plugins (version 1.9 or above)
Ticker Viz Plugins (version 1.9 or above)
Note: There are individual plug-in packages for Viz Artist 2.x and 3.x. Install the
plug-in package that corresponds to the Viz Artist version, or both packages if using
both versions.
• Viz Ticker Feed, optional software (version 2.4 or above)
• Viz Playlist Synchronizer, optional software (version 2.4 or above)
• Before installing Viz Ticker Client, the Microsoft .NET Framework 4 must be
installed on the work station.
3.1.1
Viz Ticker Feed Upgrade Issues
• Viz Ticker Feed 2.4 cannot feed data into a ticker system generated by Viz
Ticker Wizard 2.3 or older. In such cases, the corresponding Viz Ticker Feed
version should be used.
• It is possible to use Viz Ticker Feed 2.4 towards a setup generated, or
upgraded, by Viz Ticker Wizard 2.4 without changing the feed used in Viz
Ticker Feed 2.1, by using the compatibility Transformation.
3.2
Program Starting Sequence
After installation, the applications must be started in a specific sequence:
Chapter 3: Installing Viz Ticker3D
5
1. The Media Sequencer must be started before Viz Ticker Wizard and Viz Ticker
Client.
Note: A restart of the Media Sequencer requires a restart of Viz Ticker Wizard and Viz
Ticker Client. A shutdown of the Media Sequencer requires a shutdown of Viz Ticker
Wizard and Viz Ticker Client.
2. Viz Engine must be started (and put on air) before Viz Ticker Wizard.
3. Ticker Service must be running before Ticker System is enabled in Viz Ticker
Client.
Note: Viz Ticker Wizard and Viz Ticker Client can run while starting Ticker Service.
3.3
Installing Viz Ticker Wizard
This section contains information on the following topics:
• Installing Viz Ticker Wizard
• Uninstalling Viz Ticker Wizard
• Viz Ticker Wizard Startup Parameters
Installing Viz Ticker Wizard
To install Viz Ticker Wizard, perform the following steps:
Note: If Viz Ticker Wizard is already installed on the machine, first remove the old
program version before installing the new one, see Uninstalling Viz Ticker Wizard.
1. Run VizrtTickerWizard-<Product Version>.msi.
2. In the Welcome Panel, click the Next button.
6
Chapter 3: Installing Viz Ticker3D
Figure 1: Welcome Panel
3. In the Select Installation Folder Panel, make sure that the name and path of the
installation folder is correctly specified in the Folder text box.
Figure 2: Select Installation Folder Panel
Tip: Alternatively, click the Browse button to locate an existing folder or create a new
one. To see a list of drives with available space, click the Disk Cost button.
4. Click the Next button.
Viz Ticker Wizard should then be installed on the machine at the defined location.
5. In the Installation Complete Panel that appears, click the Close button.
Chapter 3: Installing Viz Ticker3D
7
Figure 3: Installation Complete Panel
Uninstalling Viz Ticker Wizard
To uninstall Viz Ticker Wizard, perform the following steps:
1. Select Start > Control Panel > Programs > Programs and Features.
The Uninstall or Change a Program Window should then open.
Figure 4: Uninstall or Change a Program Window
2. From the list of available programs, select Vizrt Ticker Wizard.
3. Click Uninstall.
4. In the window that appears, verify that the uninstallation process should
proceed by clicking Yes.
Viz Ticker Wizard should then no longer be available on the machine.
8
Chapter 3: Installing Viz Ticker3D
Note: The software settings are not deleted with the software.
3.3.1
Viz Ticker Wizard Startup Parameters
After installing Viz Ticker Wizard, the Media Sequencer startup parameter can be
modified in the Viz Ticker Wizard Properties.
Figure 5: Viz Ticker Wizard Properties
The parameter is modified in the Target text field.
If Viz Ticker Wizard should connect to a Media Sequencer on a specific machine,
type the machine name as the first parameter after the program path.
Example: "C:\Program Files\Vizrt\Viz Ticker Wizard\Ticker Wizard.exe" localhost
In the example above, Viz Ticker Wizard connects to the Media Sequencer on the
localhost machine.
3.4
Installing Viz Ticker Client
This section contains information on the following topics:
• Installing Viz Ticker Client
• Uninstalling Viz Ticker Client
• Viz Ticker Client Startup Parameters
Chapter 3: Installing Viz Ticker3D
9
Installing Viz Ticker Client
To install Viz Ticker Client, perform the following steps:
Note: If Viz Ticker Client is already installed on the machine, first remove the old
program version before installing the new one, see Uninstalling Viz Ticker Client.
1. Run VizrtTickerClient-<Product Version>.msi.
2. In the Welcome Panel, click the Next button.
Figure 6: Welcome Panel
3. In the Select Installation Folder Panel, make sure that the name and path of the
installation folder is correctly specified in the Folder text box.
Figure 7: Select Installation Folder Panel
Tip: Alternatively, click the Browse button to locate an existing folder or create a new
one. To see a list of drives with available space, click the Disk Cost button.
4. Click the Next button.
10
Chapter 3: Installing Viz Ticker3D
Viz Ticker Client should then be installed on the machine at the defined location.
5. In the Installation Complete Panel that appears, click the Close button.
Figure 8: Installation Complete Panel
Uninstalling Viz Ticker Client
To uninstall Viz Ticker Client, perform the following steps:
1. Select Start > Control Panel > Programs > Programs and Features.
The Uninstall or Change a Program Window should then open.
Figure 9: Uninstall or Change a Program Window
2. From the list of available programs, select Vizrt Ticker Client.
3. Click Uninstall.
4. In the window that appears, verify that the uninstallation process should
proceed by clicking Yes.
Chapter 3: Installing Viz Ticker3D
11
Viz Ticker Client should then no longer be available on the machine.
Note: The software settings are not deleted with the software.
3.4.1
Viz Ticker Client Startup Parameters
After installing Viz Ticker Client, various startup parameters can be modified in
the Viz Ticker Client Properties.
Figure 10: Viz Ticker Client Properties
The parameters can be added to the Target text field.
Table 1: Viz Ticker Client Startup Parameters
12
Setting
Values
Description
-msehost
hostname
Hostname of the Media
Sequencer for the Viz
Ticker3D system.
-mseconnection
socket|dcom|dcomcache
Deprecated
-vizdata
hostname
The Viz Engine host to use
for the object pool
browser.
Chapter 3: Installing Viz Ticker3D
Table 1: Viz Ticker Client Startup Parameters
Setting
Values
Description
-accessgroup
groupname
Defines the group this
client belongs to.
Carousels can be given
restricted access so that
only clients belonging to
one or more specific
groups can access it. For
more information, see
Access Groups Frame.
-config
on|off
Defines whether or not the
Configuration Panel
should be visible in Viz
Ticker Client. Usually this
is set to off on journalist
machines, and on on
operator machines.
-control
on|off
Defines whether or not the
Control Panel should be
visible in Viz Ticker Client.
Usually this is set to off on
journalist machines, and
on on operator machines.
commandqueueport
number
Socket port for external
access to client
commands.
After installation, the default Viz Ticker Client shortcut target will read:
Example: ”C:\Program Files\Vizrt\Viz Ticker Client\Viz Ticker Client.exe" -msehost
localhost -mseconnection socket -vizdata localhost -accessgroup none -config off
-control on
The example above means that the client is configured with the following setup:
•
•
•
•
•
•
-msehost localhost
-mseconnection socket
-vizdata localhost
-accessgroup none
-config off
-control on
Chapter 3: Installing Viz Ticker3D
13
4
Viz Ticker Wizard
Viz Ticker Wizard is Vizrt’s ticker configuration application.
This chapter contains information on the following topics:
•
•
•
•
•
•
•
•
•
•
4.1
Starting Up
Main Window
Main Menu
Main Panel
Ticker Carousels Panel
Output Channels Panel
GPI Panel
Settings Panel
Buttons Panel
Wizards
Starting Up
Start Viz Ticker Wizard from Start > All Programs > Vizrt > Viz Ticker3D > Viz
Ticker Wizard.
Note: If the Ticker System is currently on, it is highly recommended not to start Viz
Ticker Wizard, as the playout is likely to be disrupted.
Figure 11: Viz Ticker Wizard Startup Warning
4.2
Main Window
At system startup, the Main Window appears on the screen.
14
Chapter 4: Viz Ticker Wizard
Figure 12: Main Window
4.3
Main Menu
At the top of the Main Window is the Main Menu.
Figure 13: Main Menu
The Main Menu contains various tabs that open respective panels.
•
•
•
•
•
•
4.4
Main - Opens the Main Panel.
Ticker Carousels - Opens the Ticker Carousels Panel.
Output Channels - Opens the Output Channels Panel.
GPI - Opens the GPI Panel.
Settings - Opens the Settings Panel.
Buttons - Opens the Buttons Panel.
Main Panel
The Main Panel opens when clicking the Main Page tab in the Main Menu.
Chapter 4: Viz Ticker Wizard
15
Figure 14: Main Panel
From the Main Panel it is possible to for example connect the system to a render
engine and scan ticker scenes.
The Main Panel contains three frames:
• Viz Engine Connection Frame
• Wizards Frame
• Scene Scan Log Frame
4.4.1
Viz Engine Connection Frame
At the top of the Main Panel is the Viz Engine Connection Frame, which contains
various host and scene settings.
Figure 15: Viz Engine Connection Frame
• Host - Defines the name of the Viz Engine host Viz Ticker Wizard connects to.
For more information, see Connecting Viz Ticker Wizard to a Viz Engine Host.
• Connect - Connects Viz Ticker Wizard to the defined Viz Engine host. For
more information, see Connecting Viz Ticker Wizard to a Viz Engine Host.
• Scene - Defines the name of the currently scanned scene.
• Select Scene - Opens the Choose Scene to Scan Window. For more
information, see Scanning a Scene.
• Rescan - Rescans the currently scanned scene and informs Viz Ticker Wizard
of changes that have occurred in the scene design since the last scanning.
This section contains information on the following topics:
16
Chapter 4: Viz Ticker Wizard
•
•
•
•
•
Connecting Viz Ticker Wizard to a Viz Engine Host
Checking the Status of the Viz Engine Connection
Scanning a Scene
Rescanning a Scene
Wizards Frame
Connecting Viz Ticker Wizard to a Viz Engine Host
Most Viz Ticker Wizard options are not available until the system is successfully
connected to a Viz Engine host.
To select which Viz Engine host to connect to, perform the following steps:
1. Make sure that Viz Engine is running in On Air mode.
2. Type the desired hostname in the Host text box.
Tip: The hostname can be either a text string or an IP address.
3. Click the Connect button.
Checking the Status of the Viz Engine Connection
The Viz Engine Connection Status is displayed in the upper right corner of the
Main Window.
Figure 16: Viz Engine Connection Status
The status can be one of the following:
• Connected - Indicates that the ticker system is successfully connected to
running Viz Engine in on air mode.
• Lost Connection - Indicates that Viz Engine has been shut down correctly, and
that the ticker system is no longer connected to the Viz Engine.
• Not Connected - Indicates that no attempt has been made to connect the
ticker system to a Viz Engine.
• Not On Air - Indicates that the connected Viz Engine is not in on air mode.
• Timeout - Indicates that the ticker system is no longer connected to the
specified Viz Engine. The connection has been broken for some unknown
reason, without the Viz Engine being able to communicate the exact problem.
• Unable To Connect - Indicates that the specified Viz Engine is not running.
• Unknown Host: <hostname> - Indicates that the specified Viz Engine host
could not be found on the network.
Chapter 4: Viz Ticker Wizard
17
Scanning a Scene
To scan a scene, perform the following steps:
1. Make sure that Viz Ticker Wizard is connected to a running Viz Engine host,
see Connecting Viz Ticker Wizard to a Viz Engine Host and Checking the
Status of the Viz Engine Connection.
2. Click the Select Scene button.
The Choose Scene to Scan Window should then open.
Figure 17: Choose Scene to Scan Window
3. Browse and select the thumbnail of the desired scene.
Tip: In the Choose Scene to Scan Window, scenes can be sorted by name or date, and
presented in regular or reversed order.
The name and path of the currently selected scene will be presented in the Scene
Path text box.
4. Click the Open button. Alternatively, double-click the thumbnail.
When a scene has been successfully scanned, the scene name and path will be
presented in the Scene text box back in the Main Panel.
Rescanning a Scene
A rescan informs Viz Ticker Wizard of changes that have occurred in the scene
design since the last scanning.
18
Chapter 4: Viz Ticker Wizard
To do a rescan of the currently scanned scene, perform the following steps:
Figure 18: Viz Engine Connection Frame
1. Make sure that a scene has been scanned, see Scanning a Scene.
2. Click the Rescan button.
4.4.2
Wizards Frame
In the center of the Main Panel is the Wizards Frame.
Figure 19: Wizards Frame
The Wizards Frame contains two buttons that open wizards for creating scrolling
and flipping carousels.
• Create Scrolling Carousel - Opens the Scrolling Carousel Wizard.
• Create Flipping Carousel - Opens the Flipping Carousel Wizard.
Note: The buttons become available once respective carousel scenes have been
successfully scanned.
4.4.3
Scene Scan Log Frame
At the bottom of the Main Panel is the Scene Scan Log Frame.
Chapter 4: Viz Ticker Wizard
19
Figure 20: Scene Scan Log Frame
The Scene Scan Log Frame shows an overview of which directors, carousels, and
templates Viz Ticker Wizard identifies when scanning the currently selected
scene.
4.5
Ticker Carousels Panel
The Ticker Carousels Panel opens when clicking the Ticker Carousels tab in the
Main Menu.
20
Chapter 4: Viz Ticker Wizard
Figure 21: Ticker Carousels Panel
This section contains information on the following topics:
• Existing Carousels List
• Carousel Details Frame
4.5.1
Existing Carousels List
On the left side of the Ticker Carousels Panel is the Existing Carousels List.
Figure 22: Existing Carousels List
The Existing Carousels List contains the names of all available carousels.
Carousels become available once they have been created in one of the Wizards.
To view the details for a specific carousel in the Carousel Details Frame, doubleclick an item in the list.
4.5.2
Carousel Details Frame
In the center of the Ticker Carousels Panel is the Carousel Details Frame.
Chapter 4: Viz Ticker Wizard
21
Figure 23: Carousel Details Frame
The Carousel Details Frame shows various information about the carousel that is
currently selected in the Existing Carousels List. The settings in this frame affect
how the carousel behaves in Viz Ticker Client.
• Layer - Reflects the name of the director that holds the stop points in the Viz
Artist scene.
• State - This label is only available for scrolling carousels. The State label
reflects the name of the active in state, which can also be seen in the Scroller
Plug-in Editor’s Element Source text box.
• Carousel Caption - Defines the carousel specific tab name in Viz Ticker Client.
The caption is originally defined when setting up the carousel in one of the
carousel wizards, see Carousel Panel. For more information, see Changing the
Caption of a Carousel.
• Default Template - Defines the template that is used as default when clicking
the New Message button in the Carousel Specific Panel in Viz Ticker Client. For
more information, see Changing the Default Template for a Carousel.
• Enable TTL on - Defines an output channel that displays the two Time To Live
frames in Viz Ticker Client’s Elements Editor and makes the TTL column
available in the Carousel Frame. For more information, see Settings Frame and
Carousel List.
Note: It is only possible to enable TTL on one output channel at a time. In order to
enable an output channel, the channel must first be activated in the Output Channels
Frame.
• Enable Set As Next - If enabled, makes the Set as Next feature available in Viz
Ticker Client when right-clicking a message in the Carousel List. For more
information, see Carousel List Message Menu.
22
Chapter 4: Viz Ticker Wizard
• Spell Check - If enabled, makes the Spell Check check box selected by default
when creating a new message in Viz Ticker Client. This feature implies that the
message text will be spell checked. For more information, see Spell Checking
a Message.
• Resume Action - Defines what should happen to the carousel when resuming
from a break.
• Continue - If enabled, the system should continue where it left off when
resuming.
• Restart - If enabled, the system should restart with the first message in the
carousel when resuming from the break.
• Add Messages As - Refers to the message status when messages are added to
the Carousel List in Viz Ticker Client.
• Active - Messages are added as active on all output channels.
• Inactive - Messages are added as inactive on all output channels.
• User Controlled - Adds the Default Output Channel Activation Frame in Viz
Ticker Client, where the default activation status on each available output
channel can be defined. For more information, see Activating Messages.
• Add New Messages To - Refers to where messages should be placed after
creation in Viz Ticker Client.
• Pool - Adds new messages to the Pool List.
• Carousel - Adds new messages to the Carousel List.
This section contains information on the following topics:
•
•
•
•
•
Button Groups Available in Carousel Frame
Access Groups Frame
Setting Access Restrictions to a Carousel
Output Channels Frame
Templates Frame
Button Groups Available in Carousel Frame
The Button Groups Available in Carousel Frame lists all available button groups.
Figure 24: Button Groups Available in Carousel Frame
The items in this list reflect the items in the Button Groups and Buttons List in the
Buttons Panel.
Button groups that are selected in this list are shown in the Buttons Frame in Viz
Ticker Client’s Carousel Specific Panel.
Chapter 4: Viz Ticker Wizard
23
Access Groups Frame
The Access Groups Frame lists all groups that should have access to this carousel.
Figure 25: Access Groups Frame
Only clients that have defined the right group name in its shortcut properties will
have access to such a restricted carousel.
Setting Access Restrictions to a Carousel
To add access restrictions to a carousel, perform the following steps:
1. In the Access Groups Frame’s text field, type a descriptive group name, for
example MyAccessGroup.
2. To add another group, click the Add button.
3. Type the name of the second group in the text field, for example
AnotherAccessGroup.
4. Change the Viz Ticker Client Startup Parameters, so that the target access
group matches one of the groups defined here.
Example: -accessgroup MyAccessGroup
Output Channels Frame
The Output Channels Frame lists all available output channels.
Figure 26: Output Channels Frame
Output channels that are selected in this list are available in Viz Ticker Client. For
example, belonging On/Off buttons appear in the Actions Frame, On/Off buttons
can appear in the Buttons Frame (if the belonging button group is selected in the
Button Groups Available in Carousel Frame), and columns are created in the
Carousel Frame.
Templates Frame
At the bottom of the Carousel Details Frame is the Templates Frame.
24
Chapter 4: Viz Ticker Wizard
Figure 27: Templates Frame
The Templates Frame contains a list of all templates that are available for this
carousel. Templates are added when setting up a carousel in one of the carousel
Wizards. Each template is presented with the following information:
• Name - Shows the name of the template.
• Description - Shows the text that is displayed in the Template column in Viz
Ticker Client’s Carousel Frame.
• TTL - Shows the TTL (Time To Live) value. TTL refers to how many times a
message should run before it is taken out of the carousel.
• TTL Action - Shows what should happen to the message when the TTL value is
reached.
• Presentation - Shows the name and path of the presentation file that can be
used to create and manage messages in Viz Ticker Client. For more
information, see Presentation Files. To use the default editor, leave the text
field empty.
• Color - All messages based on this template will be displayed in Viz Ticker
Client’s Carousel List with the selected color.
For a more detailed explanation of these settings, see Scrolling Templates Panel.
The Templates frame also contains two buttons:
• Edit Templates List - Opens the Scrolling Carousel Wizard or Flipping Carousel
Wizard where it is possible to modify the template settings.
• Reimport Templates - Opens the Reimport Templates Wizard where it is
possible to reimport templates that have changed scene design. For more
information, see Reimporting Templates.
This section contains information on the following topics:
• Changing the Caption of a Carousel
• Changing the Default Template for a Carousel
• Deleting a Carousel
Changing the Caption of a Carousel
To modify the carousel caption, perform the following steps:
1. Double-click a carousel in the Existing Carousels List.
2. Type a new name in the Carousel Caption text box.
3. Click the Save button.
Chapter 4: Viz Ticker Wizard
25
For more information, see Carousel Details Frame.
Changing the Default Template for a Carousel
To modify the default template for a carousel, perform the following steps:
1. Double-click a carousel in the Existing Carousels List.
2. Select a template from the Default Template drop-down list.
3. Click the Save button.
For more information, see Carousel Details Frame.
Deleting a Carousel
To delete a carousel, perform the following steps:
1. Double-click a carousel in the Existing Carousels List.
2. Click the Delete button.
4.6
Output Channels Panel
The Output Channels Panel opens when clicking the Output Channels tab in the
Main Menu.
Figure 28: Output Channels Panel
Tip: For information about how to create a new output channel, see Output Channel
Wizard and Creating a New Output Channel.
This section contains information on the following topics:
• Existing Output Channels List
• Output Channel Details Frame
4.6.1
Existing Output Channels List
On the left side of the Output Channels Panel is the Existing Output Channels List.
26
Chapter 4: Viz Ticker Wizard
Figure 29: Existing Output Channels List
The Existing Output Channels List contains the names of all available output
channels. Output channels become available once they have been created in the
Output Channel Wizard. To view the details for a specific output channel in the
Output Channel Details Frame, double-click an item in the list.
Note: The Main output channel is automatically generated when setting up a
carousel in one of the carousel Wizards. The Main output channel is by default based
on the localhost.
4.6.2
Output Channel Details Frame
In the center of the Output Channels Panel is the Output Channel Details Frame.
Figure 30: Output Channel Details Frame
The Output Channel Details Frame shows information about the output channel
that is currently selected in the Existing Output Channels List.
• Channel Identifier - Shows the name of the output channel.
• Renderer Hostname - Shows the hostname of the Viz Engine that the ticker
system connects to when using this particular output channel.
• Renderer Port - Shows the port number of the the Viz Engine that the ticker
system connects to when using this particular output channel.
This section contains information on the following topics:
• Changing the Host of an Output Channel
• Deleting an Output Channel
Changing the Host of an Output Channel
To change the host of an existing output channel, perform the following steps:
1. Double-click an output channel in the Existing Output Channels List.
2. Type the hostname of the new render engine in the Renderer Hostname text
box.
3. Make sure that the Renderer Port number is correct.
4. Click the Save button.
Note: It is not possible to modify the channel identifier (name) of an output channel.
Chapter 4: Viz Ticker Wizard
27
Deleting an Output Channel
To delete an output channel, perform the following steps:
1. Double-click an output channel in the Existing Output Channels List.
2. Click the Delete button.
4.7
GPI Panel
The GPI Panel opens when clicking the GPI tab in the Main Menu.
Figure 31: GPI Panel
GPI units register electrical tension (voltage) in one end as high or low, and output
a digital signal (on or off) in the other end. This is used to connect control desks
and similar devices to arbitrary software. Various Vizrt software, including Viz
Ticker3D, can be controlled by GPI through the Media Sequencer.
This section contains information on the following topics:
• Existing GPI Handlers List
• GPI Settings Frame
• GPI List
4.7.1
Existing GPI Handlers List
On the left side of the GPI Panel is the Existing GPI Handlers List.
28
Chapter 4: Viz Ticker Wizard
Figure 32: Existing GPI Handlers List
The Existing GPI Handlers List contains the names of all available GPI handlers. To
view the details for a specific GPI handler in the GPI Settings Frame and GPI List,
double-click an item in the list.
This section contains information on the following topics:
• Creating a New GPI Handler
• Deleting a GPI Handler
Creating a New GPI Handler
To create a new GPI handler, perform the following steps:
1. In Viz Ticker Wizard, click the GPI tab in the Main Menu.
2. Right-click the Existing GPI Handlers List.
3. In the menu that appears, click Create New GPI Handler.
A new GPI handler will then be created and added to the Existing GPI Handlers
List.
Deleting a GPI Handler
To delete a GPI handler, perform the following steps:
1.
2.
3.
4.
In Viz Ticker Wizard, click the GPI tab in the Main Menu.
Select the handler that should be deleted in the Existing GPI Handlers List.
Right-click the Existing GPI Handlers List.
In the menu that appears, click Delete Selected GPI Handler.
The selected GPI handler will then be deleted and removed from the Existing GPI
Handlers List.
4.7.2
GPI Settings Frame
At the right side of the GPI Panel is the GPI Settings Frame.
Figure 33: GPI Settings Frame
The GPI Settings Frame shows various information about the GPI handler that is
currently selected in the Existing GPI Handlers List.
Chapter 4: Viz Ticker Wizard
29
• Handler Instance - Shows the name of the GPI handler (equal to the name in
the Existing GPI Handlers List).
• Re-initialize Handler - Re-initializes the GPI handler.
• Description - Shows a description of the GPI handler.
• Status - Shows the status of the GPI handler.
• Box Type - Defines the type of GPI box that is being configured. The box type
can be set to SRC-8, SRC-8 III, SeaLevel, or SeaLevelMAX.
• Port - Defines the port that the GPI box is connected to. The port can be set to
COM1-COM8, or none.
• Base Entry - This is the node in the Media Sequencer’s data structure where
the systems look for the GPI actions. The base entry is by default set to /sys/
gpi.
• Reverse Input Order - If enabled, the signal line that originally triggered GPI
action DL0/DH0 will now trigger GPI action DL7/DH7, the signal line that
originally triggered GPI action DL1/DH1 will now trigger GPI action DL6/DH6,
and so on. This option is only available if the box type is set to SRC-8.
• Use Card - Defines the GPI card that should be used. This option is only
available if the box type is set to SeaLevel.
• IP - Defines the IP address of the Ethernet box. This option is only available if
the box type is set to SeaLevelMAX.
• Unit - Defines the available Ethernet boxes. This option is only available if the
box type is set to SeaLevelMAX.
• Unit - Defines the unit number of the Ethernet box.
• Slave Id - Defines the Slave ID of the Ethernet box.
Advanced GPI Settings
If enabling the Show Advanced check box, the Advanced GPI Settings become
available.
Figure 34: Advanced GPI Settings
• Verbose - If enabled, the Media Sequencer’s GPI handler outputs log
information. This information can be useful for debugging.
• Data Bits - Defines the number of data bits that should be used for each
transmitted and received character. The communicating computer or device
must have the same setting. The number of databits can be set to 4-8.
• Stop Bits - Sets the interval (bps) for when characters should be transmitted.
Stop bits can be set to 1, 1.5, or 2.
• Parity - Changes the type of error checking that is used for the selected port.
The communicating computer or device must have the same setting. The
parity can be set to:
30
Chapter 4: Viz Ticker Wizard
•
•
•
•
4.7.3
• Even - A parity bit may be added to make the number of 1's in the data bits
even. This will enable error checking.
• Odd - A parity bit may be added to make the number of 1's in the data bits
odd. This will enable error checking.
• None - No parity bit will be added to the data bits sent from this port. This
will disable error checking.
• Mark - A parity bit set to 0 will be added.
• Space - A parity bit set to 1 will be added.
Baud Rate - Defines the maximum rate of bits per second (bps) that should be
transmitted through this port. The baud rate can be set to 75-128.000. It is
recommended to use the highest rate that is supported by the computer or
device that is being used.
Flow Control - Changes how the flow of data is controlled. The flow control
can be set to:
• XonXoff - Standard method of controlling the flow of data between two
modems. This type of flow control is often referred to as software
handshaking.
• Hardware - Standard method of controlling the flow of data between a
computer and a serial device. This type of flow control is often referred to as
hardware handshaking.
• None - No control of dataflow.
Sample Interval - Defines how often the PCI card should be checked for
updates. The interval is defined in microseconds. This option is only available
if the box type is set to SeaLevel.
Poll Delay - Defines how often the Ethernet box should be checked for
updates. The interval is defined in microseconds. This option is only available
if the box type is set to SeaLevelMAX.
GPI List
At the bottom of the GPI Panel is the GPI List.
Figure 35: GPI List
The GPI List contains a list of all available GPI handlers and signal lines.
• GPI Handler - Shows the GPI handler that the currently selected GPI line
belongs to.
• GPI Line - Shows the name of the GPI line.
• Server Command - Shows a text box in every row, where the action to be
performed on this GPI line can be defined.
Chapter 4: Viz Ticker Wizard
31
Example: If the server command Program Main is set to be the GPI action of DL0/
DH0, DL0 (low line 0) will set Program to off for the main feed, and DH0 (high line 0)
will set Program to on.
• Description - Shows a description of the GPI line action.
4.8
Settings Panel
The Settings Panel opens when clicking the Settings tab in the Main Menu.
Figure 36: Settings Panel
The features in this panel are related to settings in Viz Ticker Client.
Note: Viz Ticker Client must be restarted before the changes in this panel take
effect.
This section contains information on the following topics:
• Show in Main Control Frame
• Enable/Disable Features Frame
4.8.1
Show in Main Control Frame
At the top of the Settings Panel is the Show in Main Control Frame.
Figure 37: Show in Main Control Frame
• Handler Settings - Makes the Handler Settings Frame appear in Viz Ticker
Client’s Control Panel.
• Load/Save Buttons - Makes the Load and Save buttons appear in Viz Ticker
Client’s Data Frame.
• Change User - Makes the Change User button appear in Viz Ticker Client’s
Data Frame.
32
Chapter 4: Viz Ticker Wizard
Note: If both the Load/Save Buttons and Change User check boxes are cleared, the
Data Frame in Viz Ticker Client’s Control Panel will be unavailable.
4.8.2
Enable/Disable Features Frame
At the bottom of the Settings Panel is the Enable/Disable Features Frame.
Figure 38: Enable/Disable Features Frame
• Live Indicator - Enables the Live Indicator functionality, which makes it
possible to see in Viz Ticker Client’s status bar if the carousel is live on-air or
not.
Enabling the Live Indicator
To enable the Live Indicator, perform the following steps:
1. In Viz Ticker Wizard, click the Settings tab in the Main Menu.
2. In the Enable/Disable Features Frame, select the Live Indicator check box.
3. Click the Save button.
The Live Indicator in Viz Ticker Client should then become available from the
status bar (lower left corner of window).
Figure 39: Live Indicator in Viz Ticker Client
To be able to control (enable/disable) the Live Indicator from Viz Ticker Client,
buttons must be created. To create a button group, perform the following steps:
4.
5.
6.
7.
Click the Buttons tab in the Main Menu to open the Buttons Panel.
Click the New Button Group button to create a new button group.
In the Button Groups and Buttons List, select the new button group.
In the Button Group text box that appears in the Button Group/Button Details
Frame, type a descriptive name, for example Live Indicator.
8. Click the Save Changes button.
To create a button that makes it possible to enable the Live Indicator from Viz
Ticker Client, perform the following steps:
9. Click the New Button button to create a new button in the Live Indicator button
group.
10. In the Button Groups and Buttons List, select the new button.
11. In the Button Caption text box that appears in the Button Group/Button
Details Frame, type a descriptive name, for example On.
12. Drag the Live Indicator on action from the System Actions list to the Actions in
Button list.
Chapter 4: Viz Ticker Wizard
33
Note: The Live Indicator on action is only available if the Live Indicator check box is
enabled in the Settings Panel.
13. Click the Save Changes button.
To create a button that makes it possible to disable the Live Indicator from Viz
Ticker Client, perform the following steps:
14. Select the Live Indicator button group in the Button Groups and Buttons List.
15. Click the New Button button to create a new button in the Live Indicator button
group.
16. In the Button Groups and Buttons List, select the new button.
17. In the Button Caption text box that appears in the Button Group/Button
Details Frame, type a descriptive name, for example Off.
18. Drag the Live Indicator off action from the System Actions list to the Actions in
Button list.
Note: The Live Indicator off action is only available if the Live Indicator check box is
enabled in the Settings Panel.
19. Click the Save Changes button.
To make sure that the configuration is successful, perform the following steps:
20. Start Viz Ticker Client.
21. Click the Main Control tab in the Main Menu to open the Control Panel.
22. In the Actions Frame, click the Live Indicator on/off buttons to enable/disable
the feature.
The message in the status bar should change according to the Live Indicator
status.
Tip: For information about how to make the Live Indicator buttons available in the
Carousel Specific Panels in Viz Ticker Client, see Button Groups Available in Carousel
Frame.
4.9
Buttons Panel
The Buttons Panel opens when clicking the Buttons tab in the Main Menu.
34
Chapter 4: Viz Ticker Wizard
Figure 40: Buttons Panel
In the Buttons Panel it is possible to manage button groups. All button groups are
available in the Actions Frame in Viz Ticker Client’s Control Panel. It is also
possible to add button groups to the carousel specific panels, see Button Groups
Available in Carousel Frame.
This section contains information on the following topics:
• Button Groups and Buttons List
• Button Group/Button Details Frame
4.9.1
Button Groups and Buttons List
At the left side of the Buttons Panel is the Button Groups and Buttons List.
Figure 41: Button Groups and Buttons List
The Button Groups and Buttons List contains the names of all available button
groups with belonging buttons. For each output channel, there are button groups
called Ticker System and Program. For each carousel, there is also one button
group per output channel.
To view the details of a button/button group, select an item from the list. Detailed
information will the appear in the Button Group/Button Details Frame.
Chapter 4: Viz Ticker Wizard
35
To move a button/button group up or down in the list, click the arrow buttons
positioned at the right side of the list.
4.9.2
Button Group/Button Details Frame
In the center of the Buttons panel is the Button Group/Button Details Frame.
Figure 42: Button Group/Button Details Frame
If a button group is selected in the Button Groups and Buttons List, the Button
Group text box is the only option that is displayed in this frame. If a button is
selected in the Button Groups and Buttons List, the following four options are
available:
• Button Group - Defines the name of the button group. This option can only be
modified if a button group is selected in the Button Groups and Buttons List.
• Button Caption - Defines the caption that appears on the button in Viz Ticker
Client.
• Actions in Button - Lists all actions that have been applied to the selected
button.
• System Actions - Lists available actions that can be applied to the selected
button.
• Add Selected Action Button - Adds the action that is selected in the System
Actions list to the selected button.
• Remove Action Button - Removes the action that is selected in the Actions in
Button list from the selected button.
This section contains information on the following topics:
• Creating a New Button Group
• Creating a New Button
36
Chapter 4: Viz Ticker Wizard
• Deleting a Button Group
• Deleting a Button
Creating a New Button Group
To create a button group, perform the following steps:
1. In Viz Ticker Wizard, click the Buttons tab in the Main Menu.
2. In the Buttons Panel that appears, click the New Button Group button.
A new button group will then be created at the bottom of the Button Groups and
Buttons List.
3. In the Button Groups and Buttons List, click the new button group.
4. In the Button Group/Button Details Frame, type a descriptive name in the
Button Group text box.
5. Click the Save Changes button.
Creating a New Button
To create a button, perform the following steps:
1. In Viz Ticker Wizard, click the Buttons tab in the Main Menu.
2. In the Buttons Panel that appears, click the New Button button.
A new button will then be added to the button group that is currently selected in
the Button Groups and Buttons List.
3. In the Button Groups and Buttons List, click the new button.
4. In the Button Group/Button Details Frame, type a descriptive name in the
Button Caption text box.
5. Select one or more actions in the System Actions list.
6. Click the Add Selected Action button.
7. Click the Save Changes button.
Deleting a Button Group
To delete a button group, perform the following steps:
1. In Viz Ticker Wizard, click the Buttons tab in the Main Menu.
2. In the Buttons Panel that appears, click a button group in the Button Groups
and Buttons List.
3. Click the Delete Selected button.
Note: All buttons in the selected button group will be deleted too.
Deleting a Button
To delete a button, perform the following steps:
1. In Viz Ticker Wizard, click the Buttons tab in the Main Menu.
Chapter 4: Viz Ticker Wizard
37
2. In the Buttons Panel that appears, click a button in the Button Groups and
Buttons List.
3. Click the Delete Selected button.
4.10
Wizards
Various wizards are available in Viz Ticker Wizard.
This section contains information on the following topics:
•
•
•
•
4.10.1
Scrolling Carousel Wizard
Flipping Carousel Wizard
Reimport Templates Wizard
Output Channel Wizard
Scrolling Carousel Wizard
Scrolling carousel scenes are characterized by containing one or more Scroller
Plug-Ins with belonging directors and stop points. The elements in a scrolling
ticker enter the screen from one side, scroll through the screen, and exit on the
other side.
To open the Scrolling Carousel Wizard, click the Create Scrolling Carousel button
in the Main Panel.
Figure 43: Scrolling Carousel Wizard
This section contains information on the following topics:
• Carousel Panel
38
Chapter 4: Viz Ticker Wizard
•
•
•
•
•
•
•
Adding a Carousel
Scrolling Templates Panel
Adding Templates to a Scrolling Carousel
Selecting the Presentation File for a Template
Selecting Background Color for a Template
Confirm Panel
Verifying the Carousel Setup Information
Carousel Panel
The Carousel Panel opens at wizard startup.
Figure 44: Carousel Panel
The Carousel Panel contains the following options:
• Carousel Caption - Defines the carousel specific tab name in Viz Ticker
Client. By default, the carousel caption is equal to the carousel name. For more
information, see Changing the Caption of a Carousel.
• Available Carousels - Shows a list of all available carousels. Carousels become
available once a scene has been scanned. For more information, see Scanning
a Scene.
• Existing Carousels - Shows a list of all carousels that have already been
created.
Adding a Carousel
1. In the Carousel Panel, select a carousel from the Available Carousels list.
2. Click the Next button.
Chapter 4: Viz Ticker Wizard
39
Tip: Alternatively, double-click a carousel in the list.
The wizard will then proceed to the Scrolling Templates Panel or Flipping
Templates Panel.
Scrolling Templates Panel
The Scrolling Templates Panel contains a list of all available templates.
Figure 45: Scrolling Templates Panel
The settings that are defined in this panel affect messages that are created in Viz
Ticker Client. To edit the settings of a specific template, click the various
columns. Each template is presented with the following information:
• Select - Select one or more templates. The templates that are selected here
will be available when creating messages in Viz Ticker Client.
Note: The same template can be available for various carousels.
• Name - Shows the name of the template. The name is used for example when
Changing the Default Template for a Carousel. The template name is defined
in the Viz Artist scene settings, and cannot be changed in Viz Ticker Wizard.
The name reflects the template root container (direct subcontainer of
ticker_templates).
• Description - Shows the text that is displayed in the Template column in Viz
Ticker Client’s Carousel Frame. By default, the description is taken from the
ControlObject description field specified during scene design.
40
Chapter 4: Viz Ticker Wizard
Note: Non-ASCII characters must not be used in the description. Also, the system
will reset descriptions of templates that are reimported.
• TTL - Defines the TTL (Time To Live) value. TTL refers to how many times the
message should run before it is taken out of the carousel. By default, the TTL
is set to infinite (column is cleared).
• TTL Action - Defines what should happen to the message when the TTL value
is reached.
• Pool - Moves the message from the Carousel List to the Pool List.
• Remove - Deletes the message.
• Inactive - The message status is set to inactive, and the message remains in
the Carousel List.
Note: If the Show Time to Live check box has been selected in Viz Ticker Wizard’s
Ticker Carousels Panel, the TTL and TTL Action options can be modified in Viz Ticker
Client’s Settings Frame when creating or modifying a message.
• Presentation - Presentation Files can be used instead of the default editor
when messages are created or edited in Viz Ticker Client. For more
information, see Selecting the Presentation File for a Template.
• Color - All messages based on this template will be displayed in Viz Ticker
Client’s Carousel List with the selected color. For more information, see
Selecting Background Color for a Template.
Adding Templates to a Scrolling Carousel
1. In the Scrolling Templates Panel, select one or more templates from the
Available Templates list.
2. Click the Next button.
The wizard will then proceed to the Confirm Panel.
Tip: See also Adding Templates to a Flipping Carousel.
Selecting the Presentation File for a Template
Presentation Files can be used instead of the default editor when messages are
created or edited in Viz Ticker Client. Presentation Files are created in Viz
Template Wizard. To select a presentation file, perform the following steps:
1. In the Scrolling Templates Panel, click to enable the Presentation file column.
2. Click the ... button that appears.
3. In the Select Presentation File dialog box that opens, browse to locate a
presentation file (.vtw or .vtwc).
Tip: Presentation files are placed at the following location: C:\Program
Files\Vizrt\Viz Ticker Client\presentations\MyPresentationFile.vtwc.
4. Click the Open button.
For more information, see Preparing a Scrolling Carousel for Presentation File
Creation and Creating a Presentation File in Viz Template Wizard.
Chapter 4: Viz Ticker Wizard
41
Selecting Background Color for a Template
1. In the Scrolling Templates Panel, click to enable the Color column.
2. Enter the HTML color hex code in the text field that appears.
Example: #00FFFF
or
3. Click the ... button that appears.
Figure 46: Color Dialog Box
4. In the Color dialog box that opens, select a color.
5. Click the OK button.
Tip: The text color in Viz Ticker Client will automatically be adjusted to have a good
contrast to the selected background color.
Confirm Panel
The Confirm Panel contains a summary of the carousel setup information.
42
Chapter 4: Viz Ticker Wizard
Figure 47: Confirm Panel
Verifying the Carousel Setup Information
1. In the Confirm Panel, make sure that the setup information is correct.
2. Click the Finish button.
This will exit the wizard and create the new carousel.
4.10.2
Flipping Carousel Wizard
Flipping carousel scenes are characterized by containing one or more Toggle
Plug-Ins with belonging directors and stop points. The elements in a flipping
ticker are flipped in a static position.
To open the Flipping Carousel Wizard, click the Create Flipping Carousel button in
Viz Ticker Wizard’s Main Panel.
The Flipping Carousel Wizard is similar to the Scrolling Carousel Wizard. The
Carousel Panel and Confirm Panel are identical in the two wizards, while the
settings in the Scrolling Templates Panel and Flipping Templates Panel are slightly
different.
Flipping Templates Panel
The Flipping Templates Panel shows the paths and names of all available carousel
and template scenes.
Chapter 4: Viz Ticker Wizard
43
Figure 48: Flipping Templates Panel
The settings that are defined in this panel affect the messages that are created in
Viz Ticker Client. Each template is presented with information such as name,
description, TTL, TTL action, duration, presentation file, and color. For detailed
information about these settings, see Scrolling Templates Panel.
Note: The Duration column is only available for flipping templates. Duration refers to
how many seconds the message should be on-air, before flipping to the next
message in the carousel.
To edit the settings of a specific template, click the various columns in the list.
Adding Templates to a Flipping Carousel
1. In the Flipping Templates Panel, select a folder from the tree.
2. Select a thumbnail.
3. Click the Add Selected button.
Tip: Alternatively, double-click a thumbnail.
This will add the selected template to the list at the bottom of the window.
Tip: The scenes can be sorted by name or date, and presented in forward or reversed
order.
Repeat steps 2-3 until all desired templates are added to the carousel.
Tip: To delete templates from the list, select one or more templates, and then click
the Remove button.
44
Chapter 4: Viz Ticker Wizard
4. Click the Next button.
The wizard will then proceed to the Confirm Panel.
Tip: See also Adding Templates to a Scrolling Carousel.
4.10.3
Reimport Templates Wizard
The Reimport Templates Wizard allows reimporting existing templates that have
changed scene design since the original import. Templates that have changed
control plug-ins, animations, container structure, or other settings must be
reimported before the changes take effect.
Figure 49: Reimport Templates Wizard
Reimporting Templates
1. To open the Reimport Templates Wizard, click the Reimport Templates button
in the Ticker Carousels Panel.
2. In the Reimport Templates Wizard’s Reimport Templates panel, select one or
more templates that should be reimported in the Candidates for Reimport list.
3. Click the Next button.
Tip: Clicking the Select None button will clear all selections in the list. Clicking the
Select All button will select all templates in the list.
The wizard will then proceed to the Confirm panel.
4. In the Confirm panel, make sure that the reimport information is correct.
5. Click the Finish button.
Chapter 4: Viz Ticker Wizard
45
This will exit the wizard and reimport the selected templates.
Note: The selected templates will first be deleted from the Media Sequencer, and
then reimported as new templates.
4.10.4
Output Channel Wizard
The Output Channel Wizard allows creating new output channels.
Figure 50: Output Channel Wizard
The Main output channel is created by default when a carousel is set up in one of
the carousel Wizards. Other output channels must be created from this Output
Channel Wizard.
Creating a New Output Channel
To create an output channel, perform the following steps:
1. In the Output Channels Panel, click the New button.
2. In the Output Channel Wizard that opens, type a descriptive name in the
Output Channel Name text box.
3. Type the hostname of the render engine in the Renderer Hostname text box.
4. Click the Next button.
5. In the Confirm Carousel panel that appears, make sure that the output channel
settings are correct, and then click the Finish button.
This will exit the Output Channel Wizard and create a new global output channel.
46
Chapter 4: Viz Ticker Wizard
5
Viz Ticker Client
Viz Ticker Client is Vizrt’s ticker client application. This section provides
information on how to operate Viz Ticker Client.
Note: If settings that affect Viz Ticker Client are modified in Viz Ticker Wizard, Viz
Ticker Client must be restarted in order for the changes to take effect.
This chapter contains information on the following topics:
•
•
•
•
•
5.1
Starting Up
Main Menu
Control Panel
Carousel Specific Panel
Configuration Panel
Starting Up
Start Viz Ticker Client from Start > All Programs > Vizrt > Viz Ticker3D > Viz
Ticker Client.
This section contains information on:
• Logging In
5.1.1
Logging In
At system startup, the Login Window appears.
Figure 51: Login Window
The username is used for example to define the owner of messages, see Settings
Frame.
• Username - Defines the name of the current user.
• Auto Login - If enabled, the system automatically logs in with the current user
details.
Chapter 5: Viz Ticker Client
47
This section also contains information on the following topics:
• Logging In
• Enabling/Disabling the Auto Login
• Changing the User
Logging In
To log in to Viz Ticker Client, perform the following steps:
1. Start Viz Ticker Client.
Note: Make sure that the auto login function is disabled, see Enabling/Disabling the
Auto Login.
2. Type a username in the text field.
3. Click the Ok button.
Enabling/Disabling the Auto Login
1. In Viz Ticker Client’s Control Panel, click the Change User button.
Note: This button is only available if the Change User check box has been enabled in
Viz Ticker Wizard’s Settings Panel.
2. In the Login Window that opens, select/clear the Auto Login check box.
3. Click the OK button.
If the Auto Login check box is enabled, Viz Ticker Client will automatically log in
to the system with the current user details. This setting should typically be used
on a single-user computer.
If the Auto Login check box is disabled, the The username is used for example to
define the owner of messages, see Settings Frame. will appear at system startup,
and a username must be entered before being able to log in. This setting should
typically be used on a multi-user computer.
Changing the User
1. In Viz Ticker Client’s Control Panel, click the Change User button.
Note: This button is only available if the Change User check box has been enabled in
Viz Ticker Wizard’s Settings Panel.
2. In the Login Window that opens, type a username in the text box.
Note: The username is defined by the user.
3. Click the OK button.
48
Chapter 5: Viz Ticker Client
5.2
Main Menu
At system startup, the Main Window appears on the screen.
At the top of the Main Window is the Main Menu.
Figure 52: Main Menu
The Main Menu contains various tabs, which open respective panels.
• Config - Opens the Configuration Panel.
• Control - Opens the Control Panel.
The Main Menu also contains one or more carousel specific tabs. For each
available carousel, there is one tab and one carousel specific panel.
• <Carousel Specific> - Opens the Carousel Specific Panel.
5.3
Control Panel
The Control Panel opens when clicking the Control tab in Viz Ticker Client’s Main
Menu.
Figure 53: Control Panel
Note: The Control Panel is only visible if the Viz Ticker Client Startup Parameters
have been set to -control on.
This section contains information on the following topics:
Chapter 5: Viz Ticker Client
49
• Actions Frame
• Handler Settings Frame
• Data Frame
5.3.1
Actions Frame
At the left side of the Control Panel is the Actions Frame.
Figure 54: Actions Frame
The button groups and buttons in the Actions Frame reflects the list in Viz Ticker
Wizard’s Buttons Panel. The button groups and buttons are also created and
modified from the Buttons Panel.
Note: If the Control Panel is hidden, the on and off states of carousels must be
controlled from the Carousel Specific Panel. For information on how to show/hide
the Control Panel, see Uninstalling Viz Ticker Client. For information on how to add
buttons to the Carousel Specific Panel, see Button Groups Available in Carousel
Frame.
For every existing output channel, Ticker System On/Off and Program On/Off
buttons will appear in the Actions Frame.
• Ticker System On - Starts the ticker system, so that commands can be
processed and carousels sent to air.
Note: The commands are not actually processed and carousels are not actually sent
to air until Program On is activated.
• Ticker System Off - Takes the ticker system off, making sure that commands
can no longer be processed and carousels sent to air. When the ticker system
is in its off state, nothing happens if the Program On/Off or the On/Off
buttons belonging to a carousel are selected. When the Ticker System Off
button is selected, the belonging Program Off button is selected too.
The Program On/Off functionality is meant for short breaks, for example
commercial breaks.
• Program On - Sends the carousels that are in its in state to air. The Program
On button can only be selected if the belonging Ticker System On button is
selected.
• Program OFF - Takes all carousels off air. The Program Off button pauses the
carousel, so that the next message that is played when the carousel resumes,
is the next active message in the carousel. During the break (Program Off) it is
possible to apply new states to the carousels. The changes will not be
executed until the system resumes from the break (Program On).
50
Chapter 5: Viz Ticker Client
On/Off buttons belonging to each available carousel on each available output
channel are also available in the Actions Frame. All carousels can then be
controlled directly from the Actions Frame, and more importantly, the carousels
can be controlled externally with GPI.
• <Carousel Specific> On - Sends the specific carousel to air.
Note: The carousel will only go on air if the Ticker System On and Program On
buttons are selected.
• <Carousel Specific> Off - Sends the specific carousel off air.
Tip: Button groups can also be added to the Buttons Frame in the Carousel Specific
Panel. To do this, enable the belonging button group in Viz Ticker Wizard’s Button
Groups Available in Carousel Frame.
5.3.2
Handler Settings Frame
In the upper right part of the Control Panel is the Handler Settings Frame.
Figure 55: Handler Settings Frame
Note: The Handler Settings Frame is only available if the Handler Settings check box
is selected in Viz Ticker Wizard’s Settings Panel.
A handler is a component that the ticker system uses to communicate with a
certain Viz Engine. A handler has the ability to disable itself if an error occurs.
Separate handlers are created for each output channel and scrolling carousel.
This section contains information on the following topics:
•
•
•
•
Enabling a Handler
Disabling a Handler
Enabling all Handlers
Disabling all Handlers
Chapter 5: Viz Ticker Client
51
Handler List
The Handler List provides information about the handlers.
• Name - Shows the name of the handler.
Example: viz_<output channel>
• Mode - Shows the mode of the handler. The mode can be either enabled
(green label) or disabled (red label).
• Status - Shows the status of the handler. An example of a status error
message can be seen in the Troubleshooting section.
Enabling a Handler
To enable a handler in the Handler List, click the respective Set Enabled button.
Disabling a Handler
To disable a handler in the Handler List, click the respective Set Disabled button.
Enabling all Handlers
To enable all the handlers in the Handler List, click the Enable all button in the
Handler Settings Frame.
Disabling all Handlers
To disable all the handlers in the Handler List, click the Disable all button in the
Handler Settings Frame.
5.3.3
Data Frame
In the bottom right part of the Control Panel is the Data Frame.
Figure 56: Data Frame
Note: The Data Frame is only available if the Load/Save Buttons or Change User
check boxes are selected in Viz Ticker Wizard’s Settings Panel.
• Load - Opens a dialog box where previously saved carousels can be browsed
and loaded. For more information, see Loading Previously Saved Carousels.
• Save - Opens a dialog box where the current carousels can be saved as an XML
file.
• Change User - Opens the Login Window. For more information, see Logging
In.
Loading Previously Saved Carousels
To load a previously saved carousel, perform the following steps:
52
Chapter 5: Viz Ticker Client
1. In Viz Ticker Client’s Data Frame, click the Load button.
CAUTION! Loading a previously saved carousel will replace all current messages.
2. In the Open dialog box that opens, browse to find a previously saved XML file.
3. Click the Open button.
4. Click one or more Ticker System Off buttons in the Actions Frame.
Note: There are separate buttons for each available output channel.
5. Restart Viz Ticker Client.
The messages in the imported carousel will then replace the messages in the
current carousel.
5.4
Carousel Specific Panel
The Carousel Specific Panel opens when clicking the <Carousel Specific> tab in
Viz Ticker Client’s Main Menu.
The tab name is defined in Viz Ticker Wizard, either when setting up the carousel
in one of the carousel Wizards, see Carousel Panel, or when specifying the
carousel details in the Ticker Carousels Panel.
Figure 57: Carousel Specific Panel
One or more carousel specific tabs in the Main Menu open corresponding carousel
specific panels.
This section contains information on the following topics:
Chapter 5: Viz Ticker Client
53
•
•
•
•
•
5.4.1
Pool Frame
Carousel Frame
Buttons Frame
Elements Editor
Groups and Sections
Pool Frame
In the upper left part of the Carousel Specific Panel is the Pool Frame.
Figure 58: Pool Frame
The Pool Frame contains buttons for creating new messages, groups, and
sections, and also the Pool Search Area and Pool List.
• New Message - Makes it possible to create a new message in the Elements
Editor, based on the default template.
Tip: The default template is defined in Viz Ticker Wizard’s Ticker Carousels Panel.
For more information, see Changing the Default Template for a Carousel.
• New Template Element - Opens the Select Template dialog box, where any
available template can be selected. The message that opens in the Elements
Editor will be based on this template.
Tip: Templates are added in Viz Ticker Wizard when setting up the carousel in one of
the carousel Wizards, see Scrolling Templates Panel or Flipping Templates Panel.
• New Group - Makes it possible to create a new group in the Elements Editor.
For more information, see Creating a Group and Groups.
54
Chapter 5: Viz Ticker Client
• New Section: Makes it possible to create a new section in the Elements Editor.
For more information, see Creating a Section and Sections.
This section of the document also contains information on the following topics:
•
•
•
•
•
•
•
Showing/Hiding the Pool Frame
Pool Search Area
Searching Pool Items
Pool List
Pool List Menu
Pool List Message Menu
Changing the Font of Pool Items
Showing/Hiding the Pool Frame
At the right border of the Pool Frame is the thin vertically oblong Show/Hide Pool
Frame Button.
Figure 59: Show/Hide Pool Frame Button
To hide the Pool Frame, click the Show/Hide Pool Frame Button. Once the Pool
Frame is hidden, the Carousel Frame expands, the button moves to the left border
of the window, and the little arrow points to the right.
To show the Pool Frame, click the button again.
Pool Search Area
The Pool Search Area includes the Search box.
Figure 60: Pool Search Area
It is possible to search for all item types in the Pool List; messages, groups, and
sections. For more information, see Searching Pool Items.
Searching Pool Items
To search one or more items in the Pool List, perform the following steps:
Chapter 5: Viz Ticker Client
55
1. In the Search box, type one or more letters that correspond with the item
description.
2. To view the next item in the list that match the search criteria, click ENTER.
Pool List
The Pool List contains messages that should not yet be sent to air.
Tip: Inactive messages in the Carousel List basically have the same function.
Figure 61: Pool List
When new messages are created (saved), they are added either to the Pool List or
Carousel List, depending on which of the Add New Messages option buttons that
has been selected in Viz Ticker Wizard’s Ticker Carousels Panel. If the Pool option
button has been selected, new messages are added to the Pool List. If the
Carousel option button has been selected, new messages are added to the
Carousel List.
Tip: Messages can be dragged from one list to the other.
Pool List Menu
Messages can be presented in the Pool List with various information. Rightclicking the caption of the Pool List opens the Pool List Menu.
Selecting an option above the command separator in the Pool List Menu makes
the belonging column appear in the list.
• Description - Shows the actual message text.
• Template - Shows the name of the template the message is based on.
The options below the command separator refer to the layout of the list.
• Store as Default - Defines the currently selected columns as default.
• Use Default - Shows the columns in the Pool List based on the default
settings.
• Auto Fit Columns - Automatically adjusts the width of the columns.
Pool List Message Menu
Right-clicking a message in the Pool List opens the Pool List Message Menu.
•
•
•
•
•
56
Cut - Cuts the currently selected messages.
Copy - Copies the currently selected messages.
Paste - Pastes the currently cut messages.
Delete - Deletes the currently selected messages.
Show Section Headers - Enables headers for the sections in the Pool List.
Chapter 5: Viz Ticker Client
• Expand All - Expands all groups and sections in the Pool List.
• Collapse All - Collapses all groups and sections in the Pool List.
• Pool Font - Opens the Font Dialog Box, which makes it possible to select a
new font for all messages in the Pool List. For more information, see Changing
the Font of Pool Items.
Tip: See also Keyboard Shortcuts in Viz Ticker Client’s Pool Frame.
Changing the Font of Pool Items
To change the font of all items in the Pool List, perform the following steps:
1. Right-click the Pool List.
2. In the menu that appears, click Pool Font.
3. In the Font Dialog Box that opens, select a font from the Font list.
Figure 62: Font Dialog Box
4. Select a font style in the Font style list.
5. Select a font size in the Size list.
6. Click the OK button.
Note: The font settings only apply to the layout in Viz Ticker Client, not the actual
messages that are sent to air.
5.4.2
Carousel Frame
In the upper right part of the Carousel Specific Panel is the Carousel Frame.
Chapter 5: Viz Ticker Client
57
Figure 63: Carousel Frame
The Carousel Frame contains the Carousel Search Area and Carousel List.
This section contains information on the following topics:
•
•
•
•
•
•
•
Carousel Search Area
Searching Carousel Items
Carousel List
Carousel List Menu
Carousel List Message Menu
Default Output Channel Activation Frame
Activating Messages
Carousel Search Area
The Carousel Search Area includes the Search box.
Figure 64: Carousel Search Area
It is possible to search for all item types in the Carousel List; messages, groups,
and sections. For more information, see Searching Carousel Items.
Searching Carousel Items
To search one or more items in the Carousel List, perform the following steps:
1. In the Search box, type one or more letters that correspond with the item
description.
2. To view the next item in the list that match the search criteria, click ENTER.
Carousel List
The Carousel List contains groups, sections, and messages that should be taken
to air.
Carousel List Menu
Messages can be presented in the Carousel List with various information. Rightclicking the caption of the Carousel List opens the Carousel List Menu.
58
Chapter 5: Viz Ticker Client
Selecting an option above the command separator in this list makes the belonging
column appear in the list.
• Description - Shows the actual message text.
• Template - Shows the description of the template the message is based on.
This description is defined when setting up a carousel in one of the carousel
Wizards in Viz Ticker Wizard, see Scrolling Templates Panel.
• Start - Shows the message start date and time.
Note: The Start information is only available if the Date/Time settings have been
defined in the Elements Editor.
• End - Shows the message end date and time.
Note: The End information is only available if the Date/Time settings have been
defined in the Elements Editor.
• Duration - Shows how many seconds the message should be on-air, before
flipping to the next message in the carousel.
Note: The Duration column is only available for flipping carousels.
• TTL - Shows how many times the message should run before it is taken out of
the carousel. When the number of runs reaches TTL, the TTL Action will be
performed.
Note: The TTL option is only available if the Show Time to Live check box has been
selected in Viz Ticker Wizard’s Ticker Carousels Panel.
• <Output Channel> - One column is available for each output channel.
Selecting the check box in one of these columns activates the message. The
current message in the carousel is emphasized by a red arrow positioned at
the left side of the active/inactive check box. The number of times the
message has run in the carousel is displayed at the right side of the check
box.
The options below the command separator refer to the layout of the list.
• Store as Default - Defines the currently selected columns as default.
• Use Default - Shows the columns in the Carousel List based on the default
settings.
• Auto Fit Columns - Automatically adjusts the width of the columns.
Carousel List Message Menu
Right-clicking a message in the Carousel List opens the Carousel List Message
Menu.
• Set as Next on - Carousels can have multiple output channels:
• <output channel> - For this particular output channel, changes the playout
order so that the selected message is next to play.
• All Enabled Channels - On all enabled output channels, sets the currently
selected message to the next item in the carousel when resuming from a
pause.
Chapter 5: Viz Ticker Client
59
Note: The All Enabled Channels option is only available for carousels with multiple
output channels.
• Enable on - Carousels can have multiple output channels:
• All Channels - Activates the currently selected message on all output
channels.
• <output channel> - Activates the currently selected message on this
particular output channel.
• Disable on - Carousels can have multiple output channels:
• All Channels - Deactivates the currently selected message on all output
channels.
• <output channel> - Deactivates the currently selected message on this
particular output channel.
• Cut - Cuts the currently selected messages.
• Copy - Copies the currently selected messages.
• Paste - Pastes the currently cut messages.
• Delete - Moves the currently selected messages to the Pool List.
• Show Section Headers - Enables headers for the sections in the Carousel List.
• Wrap Long Lines - If enabled, the whole message descriptions will be
presented, on multiple lines if necessary.
• Expand All - Expands all groups and sections in the Carousel List.
• Collapse All - Collapses all groups and sections in the Carousel List.
• Carousel Font - Opens the Font Dialog Box, which makes it possible to select a
new font for all messages in the Carousel List. For more information, see
Changing the Font of Carousel Items.
Tip: See also Keyboard Shortcuts in Viz Ticker Client’s Pool Frame.
Changing the Font of Carousel Items
To change the font of all items in the Carousel List, perform the following steps:
1. Right-click the Carousel List.
2. In the menu that appears, click Carousel Font.
3. In the Font Dialog Box that opens, select a font from the Font list.
60
Chapter 5: Viz Ticker Client
Figure 65: Font Dialog Box
4. Select a font style in the Font style list.
5. Select a font size in the Size list.
6. Click the OK button.
Note: The font settings only apply to the layout in Viz Ticker Client, not the actual
messages that are sent to air.
Default Output Channel Activation Frame
If selecting the Add Messages as User Controlled check box in Viz Ticker Wizard’s
Ticker Carousels Panel, the Default Output Channel Activation Frame becomes
available.
Figure 66: Default Output Channel Activation Frame
In this frame it is possible to define the default activation settings for each
available output channel.
Example: If enabling the Main check box and leaving the MyOutputChannel check
box clear, messages that are added to the Carousel List will be active on the Main
channel and inactive on MyOutputChannel. Messages get their activation status
when adding them to the Carousel List, either by sending new messages directly
after message creation or dragging existing messages from the Pool List.
Activating Messages
When new messages are created, they are added with status set to either active or
inactive.
Chapter 5: Viz Ticker Client
61
To activate all new messages in a carousel, perform the following steps:
1. In Viz Ticker Wizard’s Ticker Carousels Panel, select a carousel from the
Existing Carousels List.
2. In the Carousel Details Frame that appear, click the Add Messages As Active
check box.
3. Click the Save button.
To activate existing messages, perform the following steps:
1. Right-click one or more messages in Viz Ticker Client’s Carousel List.
2. In the Carousel List Message Menu that appears, click Set Active.
Tip: Alternatively, if the <Output Channel> column is shown in the Carousel List,
activate a message by selecting the check box in front of the message.
5.4.3
Buttons Frame
In the bottom right part (center if Elements Editor is open) of the Carousel Specific
Panel is the Buttons Frame.
Figure 67: Buttons Frame
Buttons are available in this frame according to the button groups that have been
added to the carousel in Viz Ticker Wizard’s Ticker Carousels Panel, see Button
Groups Available in Carousel Frame.
Tip: The button groups in Viz Ticker Client’s Control Panel perform the same actions
as the buttons in this frame.
5.4.4
Elements Editor
At the bottom of the Carousel Specific Panel is the Elements Editor.
Figure 68: Elements Editor
In the Elements Editor, messages, groups, and sections are created and modified.
This section contains information on the following topics:
• Showing/Hiding the Elements Editor
• Data Frame
• Data Frame Menu
62
Chapter 5: Viz Ticker Client
• Date/Time Frame
• Settings Frame
Showing/Hiding the Elements Editor
At the top border of the Elements Editor is the thin horizontally oblong Show/Hide
Elements Editor Button.
Figure 69: Show/Hide Elements Editor Button
To hide the Elements Editor, click the Show/Hide Elements Editor Button. Once the
Elements Editor is hidden, the Pool Frame and Carousel Frame expand, the button
moves to the bottom border of the window, and the little arrow points upward.
To show the Elements Editor, click the button again.
Data Frame
The Data Frame becomes available when selecting the Data tab in the Elements
Editor.
Figure 70: Data Frame
The appearance of the Data Frame changes according to the item that is being
created, whether it is a message, group, or section.
Data Frame Menu
Message elements can be presented in the Data Frame with various information.
Right-clicking the caption of the Data Frame opens the Data Frame Menu.
Note: This menu is only available for message elements.
Selecting an option above the command separator in this list makes the belonging
column appear in the list.
• Description - The description text is defined in the Viz Artist scene design,
and cannot be modified in Viz Ticker3D. The description reflects the
Description text box in Viz Artist’s Control Text Plugin Editor. For more
information, see the Viz Artist User’s Guide.
• Id - Shows the element ID, starting at 1 and counting upward.
• Name - For a new empty text element, the name is defined in the Viz Artist
scene design. The description reflects the Input Value text box in Viz Artist’s
Control Text Plugin Editor. For more information, see the Viz Artist User’s
Guide. When typing text in the Message text box, the name column will
change accordingly.
• Auto Width - Automatically adjusts the width of the columns.
Chapter 5: Viz Ticker Client
63
Creating a Text Based Message
To create a new message, perform the following steps:
1. Click the New Message button in Viz Ticker Client’s Pool Frame.
This will open a new message in the Elements Editor based on the default
template.
Tip: Alternatively, click the New Template Element button in the Pool Frame. In the
Select Template dialog box that opens, select a template from the list, and then click
the OK button.
2. In the Elements Editor, make sure that the template is text based.
3. Select an element from the list, and then in the Message text box, type a
message text.
4. Repeat step 3 for all elements in the message.
For additional message settings, see Making an Item Active at a Certain Time and
Spell Checking a Message. See also Changing the Default Template for a Carousel,
Changing the Font of Pool Items, Changing the Font of Carousel Items, and
Activating Messages.
5. Click the Save button.
Note: If the element is not text based, the Geom, Image, or Material datapools will be
displayed instead of the Message text box. Instead of typing text in the text box,
select an item from the datapool.
Creating a Group
To create a new group, perform the following steps:
1. Click the New Group button in Viz Ticker Client’s Pool Frame.
This will open a new group in the Elements Editor.
2. In the Elements Editor, type a name in the Group Description text box.
3. From the Group Background Color list, select a color.
The group will be displayed in the Pool List or Carousel List with the selected
color.
For additional settings, see Making an Item Active at a Certain Time and Spell
Checking a Message. See also Changing the Font of Pool Items and Changing the
Font of Carousel Items.
4. Click the Save button.
64
Chapter 5: Viz Ticker Client
See Also
• Groups
Creating a Section
To create a new section, perform the following steps:
1. Click the New Section button in Viz Ticker Client’s Pool Frame.
This will open a new section in the Elements Editor.
2. In the Elements Editor, type a name in the Section Description text box.
3. From the Section Background Color list, select a color.
The section will be displayed in the Pool List or Carousel List with the selected
color.
For additional settings, see Making an Item Active at a Certain Time and Spell
Checking a Message. See also Changing the Font of Pool Items and Changing the
Font of Carousel Items.
4. Click the Save button.
See Also
• Sections
Date/Time Frame
The Date/Time Frame becomes available when selecting the Date/Time tab in the
Elements Editor.
Figure 71: Date/Time Frame
The time format is automatically adjusted according to the system settings on the
machine. The format is either 12 hour (01:00:00-12:59:59 AM/PM) or 24 hour
Chapter 5: Viz Ticker Client
65
(00:00:00-23:59:59). AM/PM dropdown lists become available next to the Start/
End boxes on machines with 12 hour time format.
Making an Item Active at a Certain Time
To make a message, group, or section active only at a certain time, perform the
following steps:
1. In the Date/Time Frame, type a start time and date in the Start text boxes.
2. Type an end time and date in the End text boxes.
3. Select one or more days of the week check boxes.
The message, group, or section will be active only on the selected times.
Note: If a message should be valid only on one certain date, time information must
be added, 23h 59m 59s if necessary, otherwise the information will be read as all
year around, and the information is discarded.
Settings Frame
At the right side of the Elements Editor is the Settings Frame.
Figure 72: Settings Frame
In the Settings Frame, various settings for the item can be altered.
Figure 73: Message Owner Frame
• Created By - Displays the username of the original message creator, and also
the time of creation.
• Changed By - If a message has been modified, the name of the user and the
time of the last change will be displayed.
66
Chapter 5: Viz Ticker Client
Tip: The user name is defined when Logging In.
Figure 74: Time To Live For Message Frame
• Time To Live For Message - The Time To Live (TTL) value refers to how many
times the message should run before it is taken out of the carousel.
• Forever - Sets the TTL value to infinite, so that the message runs forever.
• Set - Defines the number of times the message should run before it is taken
out of the carousel.
Figure 75: When Time To Live Is Finished Frame
• When Time To Live is Finished - This option refers to what should happen to
the message when the TTL value is reached.
• Move to Message Pool - Moves the message from the Carousel List to the
Pool List.
• Remove - Deletes the message.
• Set Inactive - The message status is set to inactive, and the message
remains in the Carousel List.
Note: The two Time To Live frames are only available if the Show Time to Live check
box has been selected in Viz Ticker Wizard’s Ticker Carousels Panel.
Figure 76: Spell Check Option
• Spell Check - If enabled, the text in the Message text box (center of the
Elements Editor when Data tab is selected) will be spell checked. For more
information, see Spell Checking a Message.
Tip: The TTL and spell check default settings for the carousel can be defined in Viz
Ticker Wizard’s Carousel Details Frame.
Spell Checking a Message
To make a message spell checked, perform the following steps:
1. Double-click an existing message in either the Pool List or Carousel List, or
create a new message, see Creating a Text Based Message.
2. In the Elements Editor, select the Spell Check check box.
Chapter 5: Viz Ticker Client
67
3. Click the Save button.
Note: The spell check function is based on the Microsoft Office dictionary, and uses
the default language in Microsoft Word.
5.4.5
Groups and Sections
Messages can be added at the root level of the Pool List or Carousel List, or they
can be added as items in Groups or Sections.
Groups
One or more groups can be added to the Pool List or Carousel List. A group can
contain one or more elements. Group settings apply for all items within the
group.
Example: Enabling a group on a certain output channel, will also enable all messages
in this group on this output channel.
For more information, see Creating a Group.
Sections
One or more sections can be added to the Pool List or Carousel List. A section can
be viewed as a group with advanced features. A section can contain one or more
elements. Section settings apply for all items within the section.
Example: Enabling a section on a certain output channel, will also enable all
messages in this section on this output channel.
Figure 77: Section Headers Shown in Carusel List
A section contains two subsections:
• Section Heads - Contains one or more heading element,s which are played out
first of all the elements. This heading element is typically a notification, that
for example informs that the following elements are news, weather, or sports
68
Chapter 5: Viz Ticker Client
messages. After a break, the section heads elements will again be played out
first, before continuing with the element that was next before going to the
break. The section heads elements are typically static, so it is possible to hide
the section headers to prevent users from accidentally updating these
elements, see Hidden Section Headers.
Figure 78: Hidden Section Headers
Tip: The section headers can be shown/hidden from the Pool List Message Menu or
Carousel List Message Menu.
• Section Elements - Contains one or more elements for the ticker.
Note: If a section contains one or more section heads elements, but no section
elements, the elements in this section will not be shown at all. (It does not make
sense to show a header with no content.)
For more information, see Creating a Section.
5.5
Configuration Panel
The Configuration Panel opens when clicking the Config tab in the Main Menu.
Chapter 5: Viz Ticker Client
69
Figure 79: Configuration Panel
Note: The Configuration Panel is only available if the Viz Ticker Client Startup
Parameters have been set to -config on.
The Configuration Panel shows a list of all existing keyboard shortcuts. From this
panel it is possible to add user defined keyboard shortcuts. It is also possible to
import a keyboard shortcut file, or to export such a file.
Note: Changing the keyboard shortcuts affects all Viz Ticker3D systems connected
to the same Media Sequencer.
• Import and Export - These functions are used to import and export shortcut
settings to and from an XML-file for backup and reuse of typical
configurations.
Note: The keyboard file has a *.kbd file extension.
• Add Macro - This function is used to write a macro command, and link it to a
shortcut key.
• Add Script - This function is used to write a Visual Basic script, and link it to a
shortcut key.
If a key combination is already in use, you are given the option of overriding the
the other command. This will leave the other command without an assigned
shortcut.
• Remove - This function makes it possible to remove macros and scripts that
are custom made. Note that no warning is issued when performing this
operation.
IMPORTANT! Avoid using SHIFT as part of a command as this will disable the
possibility to use the assigned key when writing characters (for example in upper
case).
70
Chapter 5: Viz Ticker Client
6
Ticker Specific Plug-ins
In order for a ticker carousel to work properly, the scene must be designed
according to specific Design Conventions. There are also various Viz Artist plugins that must be installed for a ticker carousel to work properly. This chapter
describes these plug-ins:
•
•
•
•
6.1
Installing the Ticker Specific Plug-ins
Scroller Plug-In
Scroller Action Plug-In
Toggle Plug-In
Installing the Ticker Specific Plug-ins
The Scroller Plug-In and Scroller Action Plug-In are available in the Ticker Viz
Plugins package. This plug-in package must be installed in order to work with
scrolling carousels in Viz Ticker3D.
The Toggle Plug-In is available in the Extra Viz Plugins package. This plug-in
package must be installed in order to work with flipping carousels in Viz
Ticker3D.
There are also numerous Control plug-ins that must be available in order to
modify messages in Viz Ticker Client. These plug-ins are, like the Toggle Plug-In,
available through the Extra Viz Plugins package. For details about these Control
plug-ins, see the Viz Artist User’s Guide.
Note: There are individual plug-in packages for Viz Artist 2 and 3. Install the plug-in
package that corresponds to the Viz Artist version, or both packages if using both
versions.
6.2
Scroller Plug-In
The Scroller Plug-in is a primitive that becomes available in Viz Artist after
installing the Ticker Viz Plugins package, see Installing the Ticker Specific Plugins.
Figure 80: Scroller Plug-in
The Scroller Plug-In is a Viz Artist function that generates a dynamic line of
scrolling elements, where each element is an instance of a template. The scroller
is able to construct and configure these templates on demand, and it manages a
pool of templates for reuse.
Chapter 6: Ticker Specific Plug-ins
71
To design a scrolling carousel, the Scroller Plug-In and one or more templates
must be added to the scene. The templates serve as prototypes for the containers
that the Scroller Plug-In generates. Alignment of the generated containers is done
by editing the alignment of the templates.
Note: Before saving a scroller scene, remember to hide the template containers,
otherwise the template prototype will show on the screen.
For more information about scroller design conventions, see Scrolling Carousel
Conventions.
6.2.1
Scroller Plug-in Editor
The Scroller Plug-in Editor contains the following settings:
Figure 81: Scroller Plug-in Editor
• Element Source - Element descriptions are added here. Either descriptions are
entered in the element source syntax, or they are put in the name of a shared
memory segment that uses the shared memory protocol. When designing and
testing a scene, the element source syntax is used to make the system scroll
instances of the design containers.
• Show Advanced - Displays additional parameters.
• Layer - Defines the layer name for the scroller. The layer name must be
identical to the name of the director that holds the in and out stop points for
the carousel.
• Mode - Defines how elements are shown. Make sure that this option is set to
Scrolling.
• Direction - Defines the direction of the scroller.
• Scroll Region Width - Defines the width of the scroller. This option is only
relevant for left-to-right/right-to-left scrollers.
72
Chapter 6: Ticker Specific Plug-ins
• Scroll Region Height - Defines the height of the scroller. This option is only
relevant for up-down/down-up scrollers.
• Scroll Speed - Defines the speed of the scroller. The x position of the scrolling
elements will be decremented with this value for each frame that passes.
• Padding - Defines an extra padding value that will be added to the width of
the bounding box of an element when calculating the spacing between the
elements. Negative padding can be used to make elements overlap.
• Show Bounds - If enabled, the area in which the scroller tries to maintain the
illusion of a continuously scrolling flow of elements is visible on screen.
• Active - Scrolling or flipping is available when enabled.
• Preload Cache - Use this on machines without ring-buffer to move all spikeload related to element creation to the initialization phase. Designs named
DESIGN_whatever_Xnnn will get nnn (where nnn is an integer) precreated
instances.
• Reinitialize - Reinitializes the plug-in by deleting all cached objects and
reconstructing the initial node structure. This parameter can be used to
update the scroller after changing for example the element source.
• Clear - Clears all current ticker elements in the rendering window.
6.3
Scroller Action Plug-In
The Scroller Action Plug-in is a tool function that becomes available in Viz Artist
after installing the Ticker Viz Plugins package, see Installing the Ticker Specific
Plug-ins.
Figure 82: Scroller Action Plug-in
The Scroller Action Plug-In makes it possible to design scrolling tickers that
trigger actions when scroller elements are played out. Actions can be triggered
both before and after reading the next element from the input source, as well as
delaying the reading of the next element a certain number of frames.
A scrolling carousel scene must have a Scroller Plug-In attached to a container
and be configured to receive elements from an external source. In most cases this
external source is the Ticker Service running on the same machine. During scene
design, it is useful to use a debugging syntax to specify a fake source that refers
to graphics templates located directly in the scene.
This section contains information on the following topics:
• Scroller Action Plug-in Editor
• Controlling Progression Using the Scroller Action Plug-In
6.3.1
Scroller Action Plug-in Editor
The Scroller Action Plug-in Editor contains the following settings:
Chapter 6: Ticker Specific Plug-ins
73
Figure 83: Scroller Action Plug-in Editor
• Delay (Frames) - Adds a delay after the current element is fully inside the
scroller, so that insertion of the next element is postponed the given number
of frames.
• On Inside - Defines if the element should trigger anything after it fully enters
the scroller.
• Action - If NONE is selected, nothing is triggered. If ANIMATE is selected, it
is possible to trigger a director and define the start and stop point of the
director animation.
• Director - Defines the director to run when On Inside is triggered.
• From Tag - Defines where to start the director animation.
• To Tag - Defines where to stop the director animation.
• After Delay - Defines if the element should trigger anything after the scroller
has finished delaying the next element.
• Action - If NONE is selected, nothing is triggered. If ANIMATE is selected, it
is possible to trigger a director and define the start and stop point of the
director animation.
• Director - Defines the director to run when After Delay is triggered.
• From Tag - Defines where to start the director animation.
• To Tag - Defines where to stop the director animation.
Example: The source syntax (separator)(text) will create a scroller showing an
endless stream of elements alternating between a separator and a text graphics
design. The scroller will search through the scene tree for containers named
separator and text, use the graphics template found there, and then copy them to
create the element instances that are being scrolled.
6.3.2
Controlling Progression Using the Scroller Action Plug-In
A typical example of when the Scroller Action Plug-In is necessary, is when SMS
messages should scroll into the screen, animate to a halt, wait a few seconds, and
then restore the scroll speed whenever new SMS messages are available.
This paragraph provides guidance on how to create an upwards scroll for
displaying SMS messages, where the scroller should pause for a while after
74
Chapter 6: Ticker Specific Plug-ins
playing out each message to the screen. The scroller should not immediately
follow the text design with the next separator design. Instead, the text design
should enter the screen fully, and then the scroller should smoothly slow down to
a halt. The scroller should wait a given number of frames before slowly starting
the scroller again and pushing the next separator element onto the screen. If an
external source is used, the scroller should not start again until there is a new
element available from the source.
To create such a behavior, perform the following tasks:
1. Create a director named scroller.
This director animates the scroller speed.
2.
3.
4.
5.
On this director, create a stop point, and call it stop.
Set the stop scroll speed to 0.
Create another stop point, and call it play.
Set the play scroll speed to a suitable speed.
The actual names that are used here are not important, but they must match the
names specified in step 8.
6. Add the Scroller Action Plug-In to the text template top node (the container
holding the ControlObject plug-in).
7. In the Scroller Action Plug-in Editor, define the Delay frame count.
This setting adds a delay after the current element, so that the insertion of the
next element is postponed the given number of frames.
The delay counter starts to count from the time the previous element has fully
entered the screen, which is a few frames after it would normally try to insert a
new element. When delay is set to 0, the scroller will perform as normal, and not
wait until the previous element has fully entered the scroller before inserting a
new element.
The delay parameter specifies the minimal amount of time that must pass
between pushing out the current element, which is based on the template
graphics with the 6.3 Scroller Action Plug-In, and the next element. The actual
amount of time might be greater if there are no new elements available after the
delay frame count has expired. Setting this parameter does not affect the speed of
the scroller, it only delays the inserting of the next element, in effect increasing
the resulting gap between the previous element and the next.
The default value of the delay frame count parameter is 0, which means that the
scroller will attempt to insert the next element immediately after the previous
element.
8. In the Scroller Action Plug-in Editor, click the On Inside: action Animate
button.
When animate is selected, three additional on inside related parameters become
available:
• On Inside: director (default value is scroller)
• On Inside: from tag (default value is play)
Chapter 6: Ticker Specific Plug-ins
75
• On Inside: to tag (default value is stop)
The parameters should remain at the default values.
When the current element has fully entered the screen, the scroller will start to
animate the scroller director from a play tag to a stop tag. The rules of the
GOTO_TRIO director command defines this behavior. For more information, see
the Transition Logic Tutorial.
9. In the Scroller Action Plug-in Editor, click the After Delay: action Animate button.
When animate is selected, three additional after delay related parameters become
available:
• After Delay: director (default value is scroller)
• After Delay: from tag (default value is stop)
• After delay: to tag (default value is play)
The parameters should remain at the default values.
When the delay frame count expires, the scroller will start to animate the scroller
director from a stop tag to a play tag. The rules of the GOTO_TRIO director
command defines this behavior. For more information, see the Transition Logic
Tutorial.
6.4
Toggle Plug-In
The Toggle Plug-in is a container function that becomes available in Viz Artist
after installing the Extra Viz Plugins package, see Installing the Ticker Specific
Plug-ins.
Figure 84: Toggle Plug-in
The Toggle Plug-In makes it possible to switch between different objects.
For more information about the Toggle Plug-In, see the Viz Artist User’s Guide
version 3.3 or above.
76
Chapter 6: Ticker Specific Plug-ins
7
Design Conventions
This chapter describes various design conventions that apply to ticker projects:
• Global Conventions
• Scrolling Carousel Conventions
• Flipping Carousel Conventions
7.1
Global Conventions
Ticker carousels are created in Viz Artist as scenes. The following design
conventions apply for all carousels (both scrolling and flipping):
• Control Plug-ins - Elements that should be modified in Viz Ticker Client must
have control plug-ins attached. The ControlObject plug-in must be added to
the template root container, while additional control plug-ins should be added
to subcontainers. For details about control plug-ins, see the Viz Artist User’s
Guide.
Example: If text should be edited, the ControlText plug-in must be applied to the
text container.
• States - Carousels must have one out state, and at least one in state. The in
states mean that the graphics is visible on screen, while the out state means
that the graphics is positioned outside the visual bounds.
Tip: The scene can have multiple stop points that define the out state, but they must
all be named O, as there is only one out state.
• Horizontal Alignment - The horizontal alignment of carousel templates can be
set to either left, right, top, or bottom. Leftward scrolling should be left
centered, rightward scrolling should be right centered, upward scrolling
should be top centered, and downward scrolling should be bottom centered.
Example: A ticker with Arabic text should typically be right centered, as Arabic is a
right-to-left language.
7.2
Scrolling Carousel Conventions
The following design conventions apply only for scrolling carousel scenes.
Scrolling carousel scenes are characterized by containing one or more Scroller
Plug-Ins with belonging directors and stop points.
A scrolling carousel scene must be designed according to the following
conventions:
Chapter 7: Design Conventions
77
• The Layer in the Scroller Plug-in Editor must be identical to the director
holding the in and out stop points.
• The Element Source in the Scroller Plug-in Editor must be identical to the in
state stop point of the layer director.
• The out state stop point of the layer director must be named the letter O. All
other states are in state stop points.
• All template containers must be organized under a root container called
ticker_templates. It is important to position the ticker_templates container at
the top of the root level of the scene tree, as Viz Artist performs a depth-first
search when identifying containers. This means that the system starts with the
first root container, and searches through all of its subcontainers, before
moving on to the second root container, and so on. Keeping template
containers high up in the tree structure improves performance.
• Do not add any containers under the container holding the Scroller Plug-In.
The scroller generates its own tree structure with copies of the template
containers.
7.3
Flipping Carousel Conventions
The following design conventions apply only for flipping carousel scenes.
Flipping carousel scenes are characterized by containing one or more Toggle
Plug-Ins with belonging directors and stop points.
A flipping carousel scene must be designed according to the following
conventions:
• The background and the templates must be built as separate scenes.
• All flipping carousel template scenes must have a root container named
object.
• The container holding the Toggle Plug-In must have the same name as the
director holding the in and out stop points.
• In the ControlObject Editor in the template scene, the Layer Identifier must be
identical to the director holding the in and out stop points in the background
scene.
• Also in the ControlObject Editor in the template scene, the State Identifier
must be identical to an in state stop point of the layer identifier director.
7.3.1
Logo Animations as Flipping Carousels
In order to create a logo animation, create a flipping carousel. While a regular
flipping carousel is equipped with multiple template elements, a logo animation is
only equipped with one. The ON and OFF buttons in Viz Ticker Client will animate
the logo in and out.
78
Chapter 7: Design Conventions
8
Importing Ticker Example Scenes
The sections Creating a Scrolling Carousel and Creating a Flipping Carousel
describe how to create ticker carousel scenes in Viz Artist 2, and also how to set
up these scenes using Viz Ticker Wizard and Viz Ticker Client.
In order to create these carousel scenes, it is assumed that users have knowledge
of how to perform basic operations in Viz Artist, such as creating scenes, adding
items, creating animations, and so on. If being unexperienced, either refer to the
Viz Artist User’s Guide while creating the scenes, or alternatively import the
scenes from available archives.
This chapter contains information on the following topics:
• Importing Viz Artist 2 Example Scenes
• Importing Viz Artist 3 Example Scenes
8.1
Importing Viz Artist 2 Example Scenes
When installing Viz Ticker Wizard, example scenes packed in a .eva archive
become available. To import the files in the archive, perform the following tasks:
1. Start Viz Artist 2.
2. From the Main menu, click Import.
3. In the Import panel that appears, browse to view the folder:
C:/Program Files/Vizrt/Viz Ticker Wizard/Examples
The Import panel should then show all archives that can be imported from the
selected folder.
4. Select the Viz2_Examples.eva archive.
5. Click the Import button.
The archive should then be imported and available from the list of scenes in Viz
Artist.
The archive contains various scenes; three flipping carousel examples, six
scrolling carousel examples, and one mixed carousels example. The archive also
contains copies of the scenes described in sections Creating a Scrolling Carousel
Scene in Viz Artist, Creating a Flipping Carousel Background Scene in Viz Artist 2,
and Creating a Flipping Carousel Template Scene in Viz Artist 2.
To view these scenes, perform the following steps:
6. From the Main menu, click Scene.
7. In the list of scenes, browse to view the folder Scene/Vizrt/Ticker/Tutorial/
Solutions.
8. Double-click one of the thumbnails of the scenes.
Chapter 8: Importing Ticker Example Scenes
79
Note: The available Viz Artist 2 example scenes are different from the Viz Artist 3
example scenes.
8.2
Importing Viz Artist 3 Example Scenes
When installing Viz Ticker Wizard, example scenes packed in a .via archive
become available. To import the files in the archive, perform the following steps:
1. Start Viz Artist 3.
2. From the Main menu, click Import.
3. In the Import panel that appears, browse to view the folder:
C:/Program Files/Vizrt/Viz Ticker Wizard/Examples
4. Make sure that Archives to Import is selected from the drop-down list at the
top of the Import panel.
The Import panel should then show all archives that can be imported from the
selected folder.
5. Select the Viz3_Examples.via archive.
6. Click the Import Archive button.
The archive should then be imported and available from the list of scenes in Viz
Artist. The archive contains various scenes; two flipping carousel examples, two
scrolling carousel examples, and one mixed carousels example.
To view the scenes, perform the following steps:
7. From the Main menu, click Server.
8. Make sure that Server - Scenes is selected from the drop-down list at the top
of the server area.
9. In the list of scenes, browse to view the project Vizrt/Tutorials/Ticker.
10. Double-click one of the thumbnails of the scenes.
Note: The available Viz Artist 3 example scenes are different from the Viz Artist 2
example scenes.
80
Chapter 8: Importing Ticker Example Scenes
9
Creating a Scrolling Carousel
This section describes how to create a scrolling carousel scene in Viz Artist and
how to set up this scene in Viz Ticker Wizard and Viz Ticker Client.
This chapter contains information on the following topics:
• Creating a Scrolling Carousel Scene in Viz Artist
• Setting Up a Scrolling Carousel in Viz Ticker3D
9.1
Creating a Scrolling Carousel Scene in Viz Artist
What characterizes a scrolling carousel is that objects, most often text messages,
enter the screen from one side, scroll through the screen, and then exit on the
other side. A scrolling carousel scene contains both design for the background
and the templates.
When the tasks in this section have been carried through, this scrolling carousel
scene will include a background, a scroller with a text message template, and
state transitions for animating the carousel in and out.
Tip: A copy of the scrolling carousel example scene has already been created and
can be imported by following the steps in Importing Viz Artist 2 Example Scenes. If
importing the example scene, skip the steps in this subsection, and jump directly to
Setting Up a Scrolling Carousel in Viz Ticker3D.
This section contains information on the following topics:
•
•
•
•
•
9.1.1
Getting Started
Adding a Background
Stopping, Starting, and Clearing the Carousel
Adding a Template
Saving the Scene
Getting Started
Tip: It is recommended to save scenes in Viz Artist regularly.
To get started, perform the following steps:
1. Start Viz Artist
Chapter 9: Creating a Scrolling Carousel
81
Figure 85: Naming the Viz Artist Scene
2. Create a new scene named tutorial-scrolling.
3. Open the new scene.
To add a group to the scene, perform the following steps:
4. From the Scene Tree’s display area, click the Groups button
5. Rename the container to LayerContainer
Tip: Always give containers descriptive names.
6. In the Transformation Editor, Position the new group to Y= -170.
9.1.2
Adding a Background
To add a background for the scene, perform the following steps:
7. From the Main menu, click Built Ins and then Geom Plugins
8. Open the Default folder
9. Drag a Rectangle to the scene tree, and place it as a subcontainer of the
LayerContainer.
• The rectangle will function as the background for the scrolling ticker. The
background can be any object, for example a circle, cube, sphere, and so
on.
82
Chapter 9: Creating a Scrolling Carousel
10. Rename the rectangle container to Background.
11. Open the Background container’s Transformation Editor and set the following
Position and Scaling values:
• Position: to Y= -10
• Scaling: X= 8, Y= 0.5, and Z= 1 (set Scaling to S (single scaling)).
Adding Color to the Background
12. Open the Rectangle editor and enable Use Vertex colors (on), and
13. Fill UpperLeft, LowerLeft, UpperRight, and LowerRight with color. In the
solution example scene, the colors have been set to:
• RGB= 232 in the upper left corner
• RGB= 163 in the lower left corner
• RGB= 255 in the upper and lower right corners
Adding the Scroller Plug-in
To add the scroller for the scene, perform the following steps:
14. From the Main menu, click Built Ins and then Geom Plugins
15. Open the Ticker folder
16. Drag the Scroller plugin to the scene tree, and place it as a subcontainer of the
LayerContainer
Chapter 9: Creating a Scrolling Carousel
83
• The Scroller Plug-In is a Viz Artist geometry that generates a dynamic line of
scrolling elements, where each element is an instance of a template.
• The Scroller Plug-In is only available if the Ticker Viz Plugins package is
installed.
Figure 86: Scene tree
Note: The scroller container name must be different from the Element source in the
Scroller editor.
17. In the Transformation Editor, set the Position of the scroller container to Z= 1.
• This will position the scroller slightly in front of the background to make
sure that the scroller content becomes visible on screen.
Figure 87: Scroller editor
18. Open the Scroller Editor, and set the following
• Element source: Headlines
• Show advanced: On (enabled)
• Layer: Tutorial
• Scroll region width: 770
• Padding: 50 (adds space between messages)
• Active: On (enabled - activates the scroller)
84
Chapter 9: Creating a Scrolling Carousel
Note: The Element source must be identical to the In state stop point of the layer
director (not created yet). The Layer name must be identical to the name of the layer
director (not created yet).
Tip: For output format 16:9, a scroll region width of 770 puts the scroller bounds
outside the screen area. This will maintain the illusion of a constantly running
scroller. For output format 4:3, the scroll region width should be at least 600.
Adding a Director
To add a director, perform the following steps:
19. From the Main menu, click Stage.
20. In the Stage editor that appears, click the Add Director button.
• A new director must be created as the Default director cannot be renamed.
21. Name the new director Tutorial.
• The name of the director is identical to the Layer name in the Scroller editor.
Adding Stop Points
The director must have at least two stop points, one for the in state and one for
the out state. Viz Ticker Client creates control buttons based on these stop
points. The ON button, based on the in state stop point, takes the carousel on air.
The OFF button, based on the out state stop point, takes the carousel off air.
To equip the director with two stop points, perform the following steps:
22. Select the Tutorial director, and set the timeline to 0
Tip: This can be done either by typing 0 in the Timeline text box in the Director
editor, by typing 0 in the Animation bar’s timeline text box, by pressing the little R
(reset) button in the Animation bar, or by dragging the timeline (the thin red vertical
line) in the Stage editor to second/frame/field 0.
23. Click the Add Stop button
24. Select the stop point that appears in the Stage editor
Chapter 9: Creating a Scrolling Carousel
85
25. In the appearing Stop Point editor enter the letter O (capitalized) to the Name
field
• O is a standard design convention for the out state.
26. Select the Tutorial director, and set the timeline to 50
27. Click the Add Stop button again, and name the new stop point Headlines
• As the O stop point is automatically the out state of the scene, this new stop
point is the in state.
Note: The in state stop point name is identical to the Element source in the Scroller
editor seen above.
Adding an Animation
To create a simple in/out animation, perform the following steps:
28. Select the LayerContainer in the Scene tree
• Make sure the timeline is at position 50
29. Click the Set key frame button in the Animation bar
30. Open LayerContainer’s Transformation editor and set Position Y to -240
31. Set the timeline to 0, and click the Set key frame button
86
Chapter 9: Creating a Scrolling Carousel
• In the Stage editor a new animation has appeared, and the animation can be
played.
32. Click the Start and Continue buttons to reset the scene to its out state, and to
run the scene to its in state
• If the previous tasks have been carried through correctly, a horizontally
oblong rectangle object will slide upwards into the screen’s lower area.
At this point, the scene tree should have the following appearance:
9.1.3
Stopping, Starting, and Clearing the Carousel
???? continue here ????
When taking a scrolling carousel off air, for example at a commercial break, the
messages in the carousel should stop scrolling. To achieve this, perform the
following steps:
1. From Viz Artist’s Main menu, click the Stage button
2. Select the Tutorial director
3. Click the Add Action button to add a new action to the director tree
4. In the appearing dialog box enter a descriptive action name (e.g.
start_stop_clear)
5. Select the new action in the director tree
6. Set the timeline to 1, and click the Add Keyframe button
A new keyframe will then be created close to the time of the scroller’s out state.
The action that is performed on this keyframe will not be visible on air as it is only
one field away from the out state. This keyframe will make sure that the carousel
is stopped when it is taken off air, so that the next message in the carousel after
the break will be the correct one. If the carousel is not stopped, the carousel will
continue to run during the break, and then the first message after the break will
be a random one, according to how long the break has lasted.
Chapter 9: Creating a Scrolling Carousel
87
Figure 88: Keyframe Editor
7. In the Keyframe editor that appears, type a descriptive name in the Name text
box, for example stop.
8. In the big text field, type
THIS_SCENE*TREE*$Scroller*GEOM*ACTIVE SET 0;
This command will disable the Active option in the Scroller editor and stop the
scroller.
9. Click the Reverse button.
This option will disable the Active option in the Scroller editor only when the timer
slides leftward.
10. Set the timeline to field 2.
11. In the Director tree, select the start_stop_clear action.
12. In the Action editor that appears, click the Add Keyframe button.
Another keyframe will then be created close to the time of the scroller out state.
This keyframe will make sure that the carousel is started when it is taken on air.
13. In the Keyframe editor that appears, type a descriptive name in the Name text
box, for example start_clear.
14. In the big text field, type
THIS_SCENE*TREE*$Scroller*GEOM*ACTIVE SET 1;
This command will enable the Active option in the Scroller editor and start the
scroller.
15. In the big text field, also add
THIS_SCENE*TREE*$Scroller*GEOM*clear INVOKE
This command will invoke the Clear option in the Scroller editor, and clear all
current messages in the scroller.
16. Click the Normal button.
This option will enable the Active option in the Scroller editor only when the timer
slides rightward.
88
Chapter 9: Creating a Scrolling Carousel
9.1.4
Adding a Template
The background is now finished. The tasks in this paragraph create a template for
messages that should be put on the scroller.
Perform the following steps:
17. Add a Group to the scene tree root, and make sure to place it at the top of the
scene tree.
18. Rename it to ticker_templates.
Note: All template containers must be subcontainers of this template root container.
It is important to position the ticker_templates container at the top of the scene tree,
above the LayerContainer, as the Scroller Plug-In caches design. When the scroller
needs to cache new design, it searches through the scene tree from the top and
downward, and selects the first match it finds. By making sure that all the templates
are located above the cache, it is assured that the copied design is originally from a
template, and not from a design that already is in the cache.
Adding a Group with a Control Function
To add a group with a control function, perform the following steps:
19. Add a new Group to the scene tree and place it as a subcontainer of the
ticker_templates container.
20. Rename it to Message.
21. From the Main menu, click Function.
Figure 89: Control Folder in Function Panel
22. Click the Container button.
23. In the list that appears, select the Control folder.
24. Drag a ControlObject to the Message container.
Any template that should be edited later must be equipped with a ControlObject
function on the template root container. As the scroller in this scene example will
roll text messages across the screen, the template must be equipped with a
control function, or else the text would be identical each time a new instance of
the template was put on the scroller.
Chapter 9: Creating a Scrolling Carousel
89
Figure 90: Position Settings in Transformation Editor
25. In the Transformation editor, set the Position to Y= -170, Z= 1.
When this scene is played in Viz Engine, the template is positioned on the scroller
independently of the template’s actual position. The template position is only set
here to provide an indication of what the finished scene is going to look like. As
the template’s origo is positioned at the right end of the scroller’s x-axis, it is
only necessary to set the Z and Y coordinates identically to the scroller
coordinates to see how it will appear.
The scene tree should now have the following appearance:
Figure 91: Scene Tree Status
Adding a Font with a Control Function
To create the actual text for the template, perform the following steps:
26. From the Main menu, click Font.
27. Drag a font to the scene tree, for example Arial-Bold, and place it as a
subcontainer of Message.
28. Rename it to Text.
Figure 92: Scaling Settings in Transformation Editor
29. In the Transformation editor, set the Scaling to X,Y,Z= 0.33.
30. From the Main menu, click Material.
90
Chapter 9: Creating a Scrolling Carousel
Figure 93: Material Editor
31. Add an orange material to the Text container, R= 255, G= 102, B= 0.
32. From the Main menu, click Function.
33. In the Function panel that appears, make sure that the Container button and
Control folder are selected.
34. Drag the ControlText plug-in to the Text container.
Note: A font template container must hold the function ControlText.
Figure 94: ControlText Editor
35. In the ControlText editor, make sure that the Expose kerning option is disabled.
36. Disable Use formatted text.
37. Type Hello there! in the Input value text box.
The text message is not placed correctly on the scroller. Reposition it by
performing the following step:
38. In the Message Transformation editor, set the Center to Y= C.
39. Position the template to Y= -170.
40. Set the Center to X= L.
Chapter 9: Creating a Scrolling Carousel
91
As this template enters the scroller from the right and exits on the left side, it is
now accurately left centered.
Note: Leftward scrolling should be left centered (X=L button), rightward scrolling
should be right centered (X=R button), upward scrolling should be top centered
(Y=T button), and downward scrolling should be bottom centered (Y=B button).
The window should now have the following appearance:
Figure 95: Scene Status
41. Click the eye symbol on the ticker_templates container.
The symbol should then reflect a closed eye, and this represents a hidden
template. If the template had not been hidden, it would appear on the screen in
its original shape whenever the scene was run in Viz Engine.
9.1.5
Saving the Scene
The scrolling carousel scene is now finished.
42. Set the scene timeline to 0.
43. Click the Save button to save the scene.
92
Chapter 9: Creating a Scrolling Carousel
9.2
Setting Up a Scrolling Carousel in Viz Ticker3D
This section provides guidance on how to set up a scrolling carousel in Viz Ticker
Wizard and Viz Ticker Client. The carousel example is based on the Viz Artist
scene tutorial-scrolling, created by following the steps in Creating a Scrolling
Carousel Scene in Viz Artist.
This section contains information on the following topics:
•
•
•
•
9.2.1
Setting Up the System
Setting Up a Scrolling Carousel in Viz Ticker Wizard
Using a Scrolling Carousel in Viz Ticker Client
Optional Scrolling Carousel Setup in Viz Ticker3D
Setting Up the System
To make sure that all the systems that are necessary to set up a scrolling carousel
is running correctly, perform the following steps:
1.
2.
3.
4.
5.
6.
9.2.2
Start Viz Artist.
Make sure that the data root in Viz Artist contains the tutorial-scrolling scene.
Set Viz Artist On Air.
Make sure that the Media Sequencer is running.
Start Viz Ticker Wizard.
Make sure that Ticker Service is running.
Setting Up a Scrolling Carousel in Viz Ticker Wizard
When starting Viz Ticker Wizard, the Main Panel is the first that appears on
screen.
Connecting to a Viz Engine Host
To connect Viz Ticker Wizard to the Viz Engine output machine, perform the
following step:
Figure 96: Viz Engine Connection Frame
7. Type the Viz Engine hostname in the Host text box.
8. Click the Connect button.
For more information, see Connecting Viz Ticker Wizard to a Viz Engine Host and
Checking the Status of the Viz Engine Connection.
Chapter 9: Creating a Scrolling Carousel
93
Selecting a Scene
Select the scrolling carousel scene, by performing the following steps:
9. Click the Select Scene button.
10. In the Choose Scene to Scan window that opens, double-click the scene
tutorial-scrolling.
For more information, see Scanning a Scene.
Setting Up a Scrolling Carousel in one of the Wizards
To set up the carousel in the Scrolling Carousel Wizard, perform the following
steps:
Figure 97: Create Scrolling Carousel Button
11. Click the Create Scrolling Carousel button.
Figure 98: Available Carousels List in Scrolling Carousel Wizard
12. In the Scrolling Carousel Wizard that opens, select the Tutorial/Headlines carousel in the Available Carousels list.
13. Click the Next button.
Figure 99: Available Templates List in Scrolling Carousel Wizard
14. In the Available Templates list, select the Message template.
15. Click the Next button.
16. Click the Finish button to confirm the new carousel.
The scrolling carousel setup in Viz Ticker Wizard is now complete.
9.2.3
Using a Scrolling Carousel in Viz Ticker Client
The carousel setup continues in Viz Ticker Client.
17. Start Viz Ticker Client.
18. From the Main Menu, make sure that the Headlines tab is selected.
Creating a new Scrolling Carousel Message
To create a new message, perform the following steps:
94
Chapter 9: Creating a Scrolling Carousel
Figure 100: New Message and New Template Element Buttons
19. Click either of the New Message or New Template Element buttons.
Note: A new message is based on the default template. The default template is
defined in the Ticker Carousels Panel in Viz Ticker Wizard. As this carousel has only
one template attached, a new message is based on the same template, whether the
New Message or New Template Element button is selected. If the carousel had
several templates attached, messages could be based on different templates.
After clicking either of the buttons, the Elements Editor appears in the lower area
of the window.
20. Type Scrolling Carousel Test in the Message text box.
21. Click the Save button.
22. Drag the message from the Pool List to the Carousel List.
Note: Messages are added to the Pool List or Carousel List depending on the settings
in the Carousel Details Frame in Viz Ticker Wizard.
Activating the System
23. Select the Main Control tab to open the Control Panel.
Note: The Control Panel is only visible if the Uninstalling Viz Ticker Client have been
set to -control on.
To activate the system, perform the following step:
Figure 101: Actions Frame in Viz Ticker Client
24. Click the Ticker System Main ON button.
25. Click the Program Main ON button.
Taking the Carousel On Air
To run the carousel, perform the following steps:
26. Select the Headlines tab to switch back to the Carousel Specific Panel.
Chapter 9: Creating a Scrolling Carousel
95
Figure 102: Buttons Frame in Viz Ticker Client
27. In the Buttons Frame, click the ON button.
Tip: Alternatively click the Headlines ON button in the Control Panel.
If the previous steps have been carried through correctly, a scrolling ticker
carousel should now be displayed in the lower area of the rendering window.
Note: The messages will only be displayed on the renderer if Installing Viz Ticker
Wizard is running.
9.2.4
Optional Scrolling Carousel Setup in Viz Ticker3D
To add new messages directly to the Carousel List (instead of the default Pool
List), and with inactive status (instead of the default active), perform the following
steps:
28. Start Viz Ticker Wizard.
29. From the Main Menu, click Ticker Carousels.
30. In the Ticker Carousels Panel that appears, double-click the Headlines
carousel in the Existing Carousels List.
Information about the carousel should then appear in the Carousel Details Frame.
Figure 103: Carousel Details Frame in Viz Ticker Wizard
31. Click the Add Messages as Inactive option button.
32. Click the Add New Messages to Carousel option button.
33. Click the Save button.
To see the actual changes in Viz Ticker Client, perform the following steps:
96
Chapter 9: Creating a Scrolling Carousel
34. Restart Viz Ticker Client.
35. Make sure that the Headlines tab is selected from the Main menu.
36. Click the New Message button.
37. Click the Save button.
Messages should now be added directly to the Carousel List, and must be
manually activated before being sent on air.
Additional Setup
• Create a new output channel and add it to the current carousel in Viz Ticker
Wizard. Notice that belonging on and off buttons appear in the Control Panel
in Viz Ticker Client.
Note: Viz Ticker Client must be restarted in order for the changes to take effect.
• Double-click a message in the Carousel List in Viz Ticker Client. The message
then opens in the Elements Editor. Notice the Created By settings, and then
edit the text message. Open the message again, and notice the Changed By
settings that have appeared.
• Create multiple new messages and try the following:
• Set various message texts
• Set various TTL values
Note: It is not recommended to use TTL values for multi-output systems, as the
behavior will be unpredictable and may not work properly. Also, the Time To Live
settings are only available if the Show Time to Live check box has been selected in
Viz Ticker Wizard’s Ticker Carousels Panel.
• Set different active/inactive status
• Move messages between the Pool List and Carousel List.
• Search for messages
Chapter 9: Creating a Scrolling Carousel
97
10 Creating a Flipping Carousel
This section describes how to create flipping carousel background and template
scenes in Viz Artist and how to set up these scenes in Viz Ticker Wizard and Viz
Ticker Client.
This chapter contains information on the following topics:
•
•
•
•
10.1
Creating a Flipping Carousel Background Scene in Viz Artist 2
Creating a Flipping Carousel Template Scene in Viz Artist 2
Setting Up a Flipping Carousel in Viz Ticker3D
Creating Flipping Carousel Messages in Viz Ticker Client
Creating a Flipping Carousel Background Scene in Viz
Artist 2
Flipping carousel scenes are characterized by containing one or more Toggle
Plug-Ins with belonging directors and stop points. The elements in a flipping
ticker are flipped in a static position.
When finished with the tasks in this section, the flipping carousel background
scene will include an animated cube object and state transitions for animating the
background in and out of the scene. A Toggle Plug-In will make it possible to add
text message template elements to the scene.
When designing scrolling carousels, both the background and one or more
templates are created within the same scene. As this scene is a flipping carousel
scene, the background and the template must be designed as different scenes.
The section Creating a Flipping Carousel Template Scene in Viz Artist 2 provides
information on how to create a standard flipping carousel template scene.
Tip: Copies of the flipping carousel example scenes have already been created and
can be imported by following the steps in Importing Viz Artist 2 Example Scenes. If
importing the example scenes, skip the steps in this subsection and section Creating
a Flipping Carousel Template Scene in Viz Artist 2, and jump directly to Setting Up a
Flipping Carousel in Viz Ticker3D.
To get started, perform the following steps:
Figure 104: Naming the Viz Artist Scene
1. Create a new scene named tutorial-flipping-back.
2. Open the new scene.
98
Chapter 10: Creating a Flipping Carousel
Adding a Cube
To add a cube object to the scene, perform the following steps:
Figure 105: Cube Object
3. Drag the built in object Cube to the scene tree.
4. Rename it to background.
Figure 106: Position Settings in Transformation Editor
5. In the Transformation editor, set the Position to X,Y= 180.
Figure 107: Cube Editor
6. In the Cube editor, set Size X to160, Size Y to 30, and Size Z to 9.
7. Set the Bevel to 2.
8. Drag a color to the background container.
Chapter 10: Creating a Flipping Carousel
99
Figure 108: Color Editor
In the solution example scene, the color has been set to R= 235, G= 237, B= 255.
At this point, the scene should have the following appearance:
Figure 109: Scene Status
Adding a Director
To create a new director, perform the following steps:
9. In the Stage editor, click the Add Director button.
10. Name the new director Tutorial.
Adding Stop Points
Add two stop points by performing the following steps:
11. Make sure that the time is set to 0.
12. Select the Tutorial director.
13. In the Director editor that appears, click the Add Stop button.
14. Select the stop point and name it O.
100
Chapter 10: Creating a Flipping Carousel
Note: Make sure to name the stop point the letter “O” (capitalized), not the number
0.
15. Set the timeline to field 50.
16. Add a new stop point named Headlines.
Adding an Animation
To create a simple in/out animation, perform the following steps:
17. Make sure that the timeline is still at field 50.
18. Select the background container in the scene tree.
19. Click the Update button in the Animation bar.
20. Set the time to 0.
Figure 110: Absolute Rotation Settings in Transformation Editor
21. In the Transformation editor, set the Absolute Rotation to X= 180.
Figure 111: Position Settings in Transformation Editor
22. Set the Position to Y= 240.
23. Click the Update button again.
In the Stage editor, a new animation has now appeared.
24. In the Director tree, drag the new background animation into the director
named Tutorial.
The director tree should now look like this:
Figure 112: Director Tree Status
The animation can now be played.
If the previous steps have been carried through correctly, a horizontally oblong
cube object should rotate downwards into the screen’s upper right corner.
Chapter 10: Creating a Flipping Carousel
101
Adding the Toggle Plug-In
To add a group with a Toggle Plug-In to the scene tree, perform the following
steps:
Figure 113: Group Plug-In
25. Add a Group to the scene tree, and place it as a subcontainer of background.
26. Rename it to Tutorial.
Figure 114: Position Settings in Transformation Editor
27. In the Transformation editor, set the Position to X= -75, Z= 17.
28. In the Function panel, click the Container button.
29. Select the Container folder.
30. Drag theToggle Plug-In onto the Tutorial container.
Note: The container holding the Toggle Plug-In must have the same name as the
director holding the stop points. Also, the Toggle Plug-In is only available if the
Extra Viz Plugins package is installed.
31. In the Toggle editor, click the Default Keyframes button.
This adds additional keyframes in the Stage editor. The Stage editor should now
have the following appearance:
102
Chapter 10: Creating a Flipping Carousel
Figure 115: Stage Editor Status
The scene tree should now have the following appearance:
Figure 116: Scene Tree Status
Saving the Scene
The flipping carousel background scene is now finished.
32. Make sure that the time is set to 0.
33. Click the Save button to save the scene.
10.2
Creating a Flipping Carousel Template Scene in Viz Artist
2
This section describes how to create a flipping carousel template scene in Viz
Artist.
Tip: A copy of the flipping carousel template scene has already been created and can
be imported by following the steps in Importing Viz Artist 2 Example Scenes. If
importing the example scenes, skip the steps in this section and section Creating a
Flipping Carousel Background Scene in Viz Artist 2, and jump directly to Setting Up a
Flipping Carousel in Viz Ticker3D.
Chapter 10: Creating a Flipping Carousel
103
When finished with the steps in this section, this template scene will be used by
the flipping carousel background scene. The Toggle Plug-In in the background
scene makes it possible to add text message templates to the carousel.
To get started, perform the following steps:
Figure 117: Naming the Viz Artist Scene
1. Create a new scene named tutorial-flipping-template.
2. Open the new scene.
Adding Group with Control Plug-In
To add a group with a control function to the scene tree, perform the following
steps:
Figure 118: Group Plug-In
3. Add a new Group to the scene tree.
4. Rename it to object.
Note: All flipping carousel template scenes must have a root container named
object.
5.
6.
7.
8.
From the Main menu, click Function.
In the Function panel that appears, click the Container button.
Select the Control folder.
Drag the ControlObject plug-in to the object container.
Placing the control plug-in on the root container optimizes the process, as the
whole template scene tree is copied when a new template is added, and the root
container is the first one to be scanned.
Figure 119: ControlObject Editor
9. In the ControlObject editor, enable Transition Logic.
10. Set the Layer identifier to Tutorial.
11. Set the State identifier to Headlines.
104
Chapter 10: Creating a Flipping Carousel
Note: The layer identifier refers to the layer director in the flipping carousel
background scene, and the state identifier refers to the in state stop point.
Figure 120: Background Scene in ControlText Editor
12. Set the Background scene to tutorial-flipping-back.
Note: The background scene is set to default if the Background scene text box is
empty.
Figure 121: Description in ControlText Editor
13. Set the Description to simple text message.
The description is used when selecting templates in Viz Ticker Wizard and Viz
Ticker Client.
Adding Font with Control Plug-In
To create the actual message text for the template, perform the following steps:
14. Drag the font Arial-Bold from the vizrt > Arial folder as a subcontainer of
object in the scene tree.
15. Rename the new container to text.
Figure 122: Scaling in Transformation Editor
16. In the Transformation editor, set the Scaling to X,Y,Z= 0.2.
With this size, the text will fit the background.
Adding Material to Font
17. Add an orange material to the text container, R= 255, G= 102, B= 0.
If no color is added, the font inherits the color of the container holding the Toggle
Plug-In in the background scene.
Adding Control Plug-In to Font
18. From the Main menu, click Function.
19. In the Function panel that appears, click the Container button.
20. Select the Control folder.
21. Drag the ControlText plug-in to the text container.
Chapter 10: Creating a Flipping Carousel
105
Figure 123: ControlText Editor
22. In the ControlText editor, make sure that the Expose kerning option is disabled.
23. Disable Use formatted text.
24. Type Hi there! in the Input value text box.
The scene tree should now have the following appearance:
Figure 124: Scene Tree Status
Editing the Position of the Template
To fine-tune the position of the template, perform the following steps:
25. Select the object container in the scene tree.
Figure 125: Center Settings in Transformation Editor
26. In the Transformation editor, set the Center to Y= C.
Note: When changing the center, the position changes too.
27. Reset the Position to Y= 0.
These changes put the center of the template scene in the center of the Toggle
Plug-In placeholder container.
The template scene should now have the following appearance:
106
Chapter 10: Creating a Flipping Carousel
Figure 126: Template Scene Output
Saving the Scene
The template scene is now finished.
28. Click the Save button to save the scene.
10.3
Setting Up a Flipping Carousel in Viz Ticker3D
This section of the document provides information on how to set up a flipping
carousel in Viz Ticker Wizard and Viz Ticker Client. The flipping carousel will be
based on the scenes created in Creating a Flipping Carousel Background Scene in
Viz Artist 2 and Creating a Flipping Carousel Template Scene in Viz Artist 2.
Setting Up the System
To make sure that all the systems that are necessary to set up a flipping carousel
are running correctly, perform the following steps:
1. Start Viz Artist.
2. Make sure that the data root in Viz Artist contains the tutorial-flipping-back
and tutorial-flipping-template scenes.
3. Set Viz Artist On Air.
4. Make sure that the Media Sequencer is running.
5. Start Viz Ticker Wizard.
Creating a Flipping Carousel in Viz Ticker Wizard
6. Delete any existing carousels or output channels.
7. Click the Main Page tab in the Main Menu.
8. In the Main Panel that appears, type the preferred Viz Engine hostname in the
Host text box.
9. Click the Connect button.
10. Click the Select Scene button.
Chapter 10: Creating a Flipping Carousel
107
11. In the Choose Scene to Scan window that opens, double-click the scene
tutorial-flipping-back.
Setting Up a Flipping Carousel in one of the Wizards
Figure 127: Create Flipping Carousel Button
12. Click the Create Flipping Carousel button.
Figure 128: Available Carousels Frame in Flipping Carousel Wizard
13. In the Flipping Carousel Wizard that opens, select the carousel Tutorial from
the Available Carousels list.
14. Click the Next button.
108
Chapter 10: Creating a Flipping Carousel
Figure 129: Flipping Templates Panel in Flipping Carousel Wizard
15. Double-click the tutorial-flipping-template scene.
16. Click the Next button.
17. Click the Finish button to confirm the new carousel.
The flipping carousel setup in Viz Ticker Wizard is now complete.
10.4
Creating Flipping Carousel Messages in Viz Ticker Client
The flipping carousel setup continues in Viz Ticker Client.
18. Start Viz Ticker Client.
Creating a New Flipping Carousel Message
To create a new message, perform the following steps:
19. From the Main Menu, make sure that the Tutorial tab is selected.
20. Click the New Message button.
21. In the Message text box, type Test 1.
22. Click the Save button.
23. Click the New Message button again.
24. In the Message text box, type Test 2.
25. Click the Save button.
26. Drag both messages from the Pool List to the Carousel List.
Activating the System
To activate the system, perform the following steps:
27. Click the Main Control tab to open the Control Panel.
Chapter 10: Creating a Flipping Carousel
109
28. Click the Ticker System Main ON button.
29. Click the Program Main ON button.
Taking the Carousel On Air
To run the carousel, perform the following step:
30. Select the Tutorial tab to switch back to the Carousel Specific Panel.
Figure 130: Buttons Frame in Viz Ticker Client
31. In the Buttons Frame, click the ON button.
Tip: Alternatively click the Tutorial ON button in the Control Panel.
If the previous steps have been carried through correctly, a flipping carousel
should now be displayed in the upper right corner of the rendering window.
110
Chapter 10: Creating a Flipping Carousel
11 Viz Ticker Feed
Viz Ticker Feed is a Viz Ticker3D add-on program that makes it possible to
populate a scrolling or flipping carousel with data elements from an external
source. The program can access the file through a URL, which is checked for
updates at a defined interval.
Viz Ticker Feed communicates with the Viz Ticker3D system through the Media
Sequencer, which is the server process for a Ticker system.
This chapter contains information on the following topics:
•
•
•
•
11.1
Getting Started
System Configuration
XML Data Structure
Viz Ticker Feed Troubleshooting
Getting Started
This section contains the following procedures:
•
•
•
•
•
Installing Viz Ticker Feed
Uninstalling Viz Ticker Feed
Setting Up a Single Source Viz Ticker Feed
Setting Up a Multi Source Viz Ticker Feed
Starting Viz Ticker Feed
Installing Viz Ticker Feed
Viz Ticker Feed is distributed as an MSI installer. To install Viz Ticker Feed,
perform the following steps:
Note: If Viz Ticker Feed is already installed on the machine, first remove the old
program version, see Uninstalling Viz Ticker Feed.
1. Run VizrtTickerFeed-<Product Version>.msi.
2. In the Custom Setup Panel, make sure that the name and path of the
installation folder is correctly specified in the Location field.
Chapter 11: Viz Ticker Feed
111
Figure 131: Custom Setup Panel
Tip: Alternatively, click the Browse button to locate an existing folder or create a new
one. To see a list of drives with available space, click the Disk Cost button.
3. Click the Next button.
4. In the Ready to Install Panel that appears, click the Install button.
Figure 132: Ready to Install Panel
Viz Ticker Feed should then be installed on the machine at the defined location.
5. In the Complete Panel that appears, click the Finish button.
112
Chapter 11: Viz Ticker Feed
Figure 133: Complete Panel
Uninstalling Viz Ticker Feed
To uninstall Viz Ticker Feed, perform the following steps:
1. Select Start > Control Panel > Programs > Programs and Features.
The Uninstall or Change a Program Window should then open.
Figure 134: Uninstall or Change a Program Window
2. From the list of available programs, select Vizrt Ticker Feed.
3. Click Uninstall.
4. In the window that appears, verify that the uninstallation process should
proceed by clicking Yes.
Viz Ticker Feed should then no longer be available on the machine.
Chapter 11: Viz Ticker Feed
113
Note: The software settings are not deleted with the software.
Setting Up a Single Source Viz Ticker Feed
To configure a single source Viz Ticker Feed, perform the following steps:
1. Click Start > All Programs > Vizrt > Viz Ticker3D > Viz Ticker Feed > Open
Settings Folder.
This will open the folder where the default.ini file is located.
Figure 135: default.ini
The default.ini file must be created under %PROGRAMDATA%\Vizrt\Viz Ticker
Feed Settings\. The file can be manually copied from the Viz Ticker Feed
installation folder, where it is called default.ini.example, and then renamed to
default.ini. Alternatively start Viz Ticker Feed once, and the system will
automatically perform the copying/renaming operation.
2. Open the default.ini file.
3. Define the Media Sequencer Hostname.
Example: mseq-hostname=localhost
4. Define the Source XML-file that should feed data elements to the Ticker
system.
Example: source=ftp://user:pass@ftp.localserver.com/newsfeed.xml
5. Define the Transformation.
114
Chapter 11: Viz Ticker Feed
Example: transformation=feedcomp:rss20,xsl:filters\rss20_to_TickerFeedExample.x
sl
Setting Up a Multi Source Viz Ticker Feed
In order to set up a multi source Viz Ticker Feed configuration, it is necessary to
launch one Viz Ticker Feed instance for each source. Each source must also have a
separate INI-file.
To configure a multi source Viz Ticker Feed, perform the following steps:
1. Click Start > All Programs > Vizrt > Viz Ticker3D > Viz Ticker Feed > Open
Settings Folder.
This will open the folder where the default.ini file is located.
Figure 136: default.ini
The default.ini file must be created under %PROGRAMDATA%\Vizrt\Viz Ticker
Feed Settings\. The file can be manually copied from the Viz Ticker Feed
installation folder, where it is called default.ini.example, and then renamed to
default.ini. Alternatively start Viz Ticker Feed once, and the system will
automatically perform the copying/renaming operation.
2. Save the default.ini file with a new descriptive name, for example internal.ini and place it in the same folder.
3. Create a shortcut of the ticker_feed.exe file found at C:\Program
Files\Vizrt\Viz Ticker Feed (if installed at default installation folder
path).
4. In the Viz Ticker Feed Properties text box, type --inifile=internal.ini (if
the example file name above has been used).
Chapter 11: Viz Ticker Feed
115
Figure 137: Viz Ticker Feed Properties
5. Define the Media Sequencer Hostname.
Example: mseq-hostname=localhost
6. Define the Source XML-file that should feed data elements to the Ticker
system.
Example: source=ftp://user:pass@ftp.localserver.com/newsfeed.xml
7. Define the Transformation.
Example: transformation=feedcomp:rss20,xsl:filters\rss20_to_TickerFeedExample.x
sl
For all additional sources, repeat the steps in this procedure so that one Viz
Ticker Feed instance with a separate INI-file can be launched for each source.
Make sure to name the INI-file and instance parameter differently for each source.
Starting Viz Ticker Feed
To start Viz Ticker Feed, perform the following step:
Note: The correct INI-file settings must be entered before the program is started.
For more information, see Setting Up a Single Source Viz Ticker Feed.
116
Chapter 11: Viz Ticker Feed
• Click Start > All Programs > Vizrt > Viz Ticker Feed > Viz Ticker Feed.
When launched, the program will start to monitor a URL and send data to the
Media Sequencer.
11.2
System Configuration
The Viz Ticker Feed configuration file is named default.ini. The following settings
can be defined in the INI-file:
•
•
•
•
11.2.1
Media Sequencer Hostname
Source
Transformation
Log Level
Media Sequencer Hostname
Viz Ticker Feed communicates with the Viz Ticker3D system through the Media
Sequencer, which is the server process for a Ticker system. The Media Sequencer
can be targeted either by hostname or IP address:
mseq-hostname=localhost
11.2.2
Source
Viz Ticker Feed makes it possible to populate a ticker carousel with data elements
from an external source. The program access the file through a URL, which is
checked for updates at a defined interval. Valid source URL schemes are file,
HTTP, and FTP. For more information about source XML-files, see XML Data
Structure.
• File on disk source=file:///C|/feed/data.xml
• Web Resource (HTTP) source=http://www.newspaper.com/news/viz_feed.xml
• FTP Server source=ftp://user:pass@ftp.localserver.com/newsfeed.xml
Special rules apply to the URL reference for files on disk:
• The path must be absolute, not relative.
• Instead of C:\file.xml, type C|/file.xml.
Also, when using a disk file as source, it is advisable to write to a temporary file
and then copy content to the file that is being monitored. This reduces the chance
of reading corrupt/incomplete files.
Chapter 11: Viz Ticker Feed
117
11.2.3
Transformation
If the source data provides acceptable output in XML format, it is not necessary to
define the transformation settings. If the source data must be converted to
acceptable XML format, specify one or more transformations of the form:
<type-1>:<transformation-1>,<type-2>:<transformation-2>,...
Currently recognized transformation types are:
• xsl - Specify an XSL-file as transformation. If the feed source outputs XML, but
of a different format, write an XSL transformation to be applied to the feed
data, for example:
transformation=xsl:c:\feedtools\yourxml_to_tickerxml.xsl
• prog - Specify an external executable as transformation. The feed data will be
piped through the program via standard input/output. If for example the feed
source outputs data as lines of text, write a VB script to translate this to XML
and specify like this:
transformation=prog:cscript //NoLogo
c:\feedtools\yourdata_to_tickerxml.vbs
Tip: For more information, see the example script in textfile_to_xml.vbs. The file can
be found at C:\Program Files\Vizrt\Viz Ticker Feed\filters (if installed at default
installation folder path).
• feedcomp - Apply a built-in transformation to the feed data. Currently
available transformations are:
• rss20 - Transforms any RSS XML to the RSS 2.0 format. To read any RSS feed
and insert it into the ticker, write for example:
transformation=feedcomp:rss20,xsl:filters\rss20_to_TickerFeedExampl
e.xsl
Tip: For more information, see the example script in
rss20_to_TickerFeedExample.xsl. The file can be found at C:\Program
Files\Vizrt\Viz Ticker Feed\filters (if installed at default installation folder path).
If the feed is not trusted, it is possible to apply a censoring filter before
inserting the messages to the ticker, for example:
transformation=feedcomp:rss20,prog:c:\feedtools\rss_censor.exe,xsl:
rss20_to_TickerFeedExample.xsl
• compatibility - Transforms input xml in formats of previous versions to the
current format.
transformation=xsl:filters\elementlists_to_tickerfeed.xsl,feedcomp:
compatibility
Using External Programs to Transform Feed Data
The value specified under the transformation key is a transformation pipeline,
meaning that it enumerates a sequence of transformation steps that data
118
Chapter 11: Viz Ticker Feed
obtained from the data source will pass through before being applied to the ticker
system.
One of the transformation steps that can be configured is a transformation of type
prog, which specifies an external executable that the data will be piped through.
This means that the data will be piped into the standard-in stream of the
executable process, and data will be read back out from the program through the
standard-out stream of the executable process.
This places the following requirements on executables that can be used for
transforming data:
• The executable must read all data provided to it on standard-in fully. The
executable cannot choose to not read some of the data provided, since doing
so will cause a Pipe Broken error to be generated when the application exits
without having read all available data, and this will prevent the transformation
pipeline from working.
• The executable must write all outgoing data to standard-out before ending
the process.
• The executable must end the process with exit code 0 to indicate that the
transformation was successful. Any other exit code will be interpreted as an
error, and the entire output will be discarded.
If the Transformation Error below appears in the console or log file, the system
has most likely tried to use an external executable that did not read all the data it
was given on standard-in before it exited. To fix this problem, modify the
external program so that it runs in a loop, reading all available data from
standard-in input stream until it reaches the end-of-file (EOF) marker in the input
stream. Only then let the program exit.
Figure 138: Transformation Error
11.2.4
Log Level
It is possible to define various logging levels for Viz Ticker Feed. The log level can
be set to:
• debug - Logs all necessary information, useful for debugging purposes as it
maximizes the logging detail.
• info - Logs information necessary for normal use. This log level is selected by
default.
• error - Logs only critical errors
log_level=debug
11.3
XML Data Structure
This section of the document contains information on the following topics:
Chapter 11: Viz Ticker Feed
119
• XML Example
• XML DTD
11.3.1
XML Example
This section contains an example of the standard XML format for feeding data
into a ticker carousel. It corresponds to the Document Type Definition specified in
XML DTD.
IMPORTANT! If the input source has an XML format that vary from the Viz Ticker
Feed XML data structure, it is necessary to create an XSL transformation file to
convert it to this format. If the input source is not in XML format, create a program/
script that converts the input to XML.
Viz Ticker Feed understands the following data structure:
11.3.2
XML DTD
The XML format that is used for feeding data into a ticker carousel can also be
described as an XML Document Type Definition (DTD):
<!ELEMENT tickerfeed (playlist*)>
<!ATTLIST tickerfeed version CDATA #FIXED "2.4">
<!ELEMENT playlist (defaults?,(element|group|section)*)>
<!ATTLIST playlist type (flipping_carousel|scrolling_carousel)
#REQUIRED
name CDATA #REQUIRED
target (carousel|pool) #REQUIRED>
<!ELEMENT defaults (field|duration|outputchannels|timematch|ttl|
template|gui-color|attributes)*>
<!ELEMENT element (field|duration|outputchannels|timematch|ttl|
template|gui-color|attributes)*>
<!ELEMENT group (description,(outputchannels|
timematch|gui-color)*,elements?)>
<!ATTLIST group use_existing CDATA #IMPLIED>
<!ELEMENT description (#PCDATA)>
<!ELEMENT elements (group|section|element)*>
<!ELEMENT section (description,(outputchannels|
timematch|gui-color)*,head?,body?)>
<!ATTLIST section use_existing CDATA #IMPLIED>
<!ELEMENT head (element|group|section)*>
120
Chapter 11: Viz Ticker Feed
<!ELEMENT body (element|group|section)*>
<!ELEMENT field (#PCDATA)>
<!ATTLIST field name CDATA #REQUIRED>
<!ELEMENT duration (#PCDATA)>
<!ELEMENT outputchannels (active*)>
<!ELEMENT active (#PCDATA)>
<!ELEMENT timematch (begin,end)>
<!ELEMENT begin (#PCDATA)>
<!ELEMENT end (#PCDATA)>
<!ELEMENT ttl (#PCDATA)>
<!ATTLIST ttl action CDATA #REQUIRED>
<!ELEMENT template (#PCDATA)>
<!ELEMENT gui-color (#PCDATA)>
<!ELEMENT attributes (attribute*)>
<!ELEMENT attribute (#PCDATA)>
<!ATTLIST attribute name CDATA #REQUIRED>
XML DTD Explanation
<!ELEMENT tickerfeed (playlist*)>
<!ATTLIST tickerfeed version CDATA #FIXED "2.4">
<tickerfeed> is the root container for the entire feed.
• <tickerfeed> can contain any number of <playlist> nodes.
<!ELEMENT playlist (defaults?,(element|group|section)*)>
<!ATTLIST playlist type (flipping_carousel|scrolling_carousel)
#REQUIRED
name CDATA #REQUIRED
target (carousel|pool) #REQUIRED>
<playlist> is a collection of elements, groups, and sections.
• Attribute type is either “flipping_carousel” or “scrolling_carousel”.
• Attribute name must correspond to the ticker name, as listed in Viz Ticker
Wizard. The name does not necessarily equal the tab name in Viz Ticker
Client.
• Attribute target is either "carousel" or "pool", and specifies where the elements
should be inserted.
• Can contain zero or one <defaults>.
• Can contain any number of <element>, <group>, and <section> nodes.
<!ELEMENT element (field|duration|outputchannels|timematch|ttl|
template|gui-color|attributes)*>
<element> refers to an actual ticker message. This container has no attributes.
• Can contain any number of <field> nodes.
• Can contain zero or one <duration> node.
• Can contain zero or one <outputchannels> node.
Chapter 11: Viz Ticker Feed
121
• Can contain zero or one <timematch> node.
• Can contain zero or one <ttl> node.
• Can contain zero or one <template> node. If a <template> node is not
present, it must be defined in a <defaults> node.
• Can contain zero or one <gui-color> node.
• Can contain zero or one <attributes> node.
<!ELEMENT defaults (field|duration|outputchannels|timematch|ttl|
template|gui-color|attributes)*>
A <defaults> node is similar to an <element> node, but contains default values
that will be set on all <element>, <section>, and <group> nodes in the same
<playlist> node, unless they explicitly set the values otherwise.
<!ELEMENT group (description,(outputchannels|
timematch|gui-color)*,elements?)>
<!ATTLIST group use_existing CDATA #IMPLIED>
Corresponds to a group in the Viz Ticker Client rundown.
• The optional attribute "use_existing" can be set to "yes". If set otherwise, or
missing, it will be treated as "no". When set to "yes", Viz Ticker Feed will not
create a new group, but instead locate and use an existing group with the
same description as this, and use that instead. If no such group exists, an
error will be reported and no messages will be added.
• Can contain zero or one <outputchannels> node.
• Can contain zero or one <timematch> node.
• Can contain zero or one <gui-color> node.
• Must contain one <description> node.
• Can contain zero or one <elements> nodes.
<!ELEMENT description (#PCDATA)>
The group's description. Visible in the rundown, and the same as can otherwise
be manually set in Viz Ticker Client for non-feeded groups.
<!ELEMENT elements (group|section|element)*>
Constitutes the list of messages under a group.
• Can contain any number of <element>, <group>, and <section> nodes.
<!ELEMENT section (description,(outputchannels|
timematch|gui-color)*,head?,body?)>
<!ATTLIST section use_existing CDATA #IMPLIED>
Corresponds to a <section> in the Viz Ticker Client rundown.
• The optional attribute "use_existing" can be set to "yes". If set otherwise, or
missing, it will be treated as "no". When set to "yes", Viz Ticker Feed will not
create a new group, but instead locate and use an existing group with the
same description as this, and use that instead. If no such group exists, an
error will be reported and no messages will be added.
• Can contain zero or one <outputchannels> node.
• Can contain zero or one <timematch> node.
• Can contain zero or one <gui-color> node.
122
Chapter 11: Viz Ticker Feed
• Must contain one <description> node.
• Can contain zero or one <head> nodes.
• Can contain zero or one <body> nodes.
<!ELEMENT head (element|group|section)*>
<head> constitutes the list of header messages under a section.
• Can contain any number of <element>, <group>, and <section> nodes.
<!ELEMENT body (element|group|section)*>
<body> constitutes the list of messages under a section.
•
Can contain any number of <element>, <group>, and <section> nodes.
<!ELEMENT field (#PCDATA)>
<!ATTLIST field name CDATA #REQUIRED>
Refers to the data field, as designed in the scene template, and also visible as a
line in the standard Viz Ticker Client editor.
• Attribute "name" must be the same as the attribute name defined in the
template.
• Contains the field value as a text string.
<!ELEMENT duration (#PCDATA)>
Defines the duration of a flipping message.
• Contains duration as a text string. Must be in plain numerical format, with "."
as the decimal separator if applicable.
<!ELEMENT outputchannels (active*)>
Defines which output channels an element/group/section should be enabled for.
If <outputchannels> is not specified at all, the element/group/section will be
enabled for all available channels. If specified, the element/group/section will
only be enabled for the specified channels.
• Can contain any number of <active> nodes.
<!ELEMENT active (#PCDATA)>
<active> means an element should be enabled for this channel. The channel's
check box will be selected in the rundown.
• Contains the output channel name as a text string.
<!ELEMENT timematch (begin,end)>
<timematch> means an element/group/section should only be considered
enabled during a specified time.
• Must contain one <begin> node.
• Must contain one <end> node.
Chapter 11: Viz Ticker Feed
123
<!ELEMENT begin (#PCDATA)>
Contains begin timecode as text string. If the element should be valid only at a
specific time interval, this attribute describes the start time. It can contain either a
crontab timecode or a 24-hour hh:mm:ss string, for example 14:30:00. The
crontab timecode is almost in standard Unix crontab format, except the ‘/’
operator is not supported and it has an extra seconds field. For example 00 00 22
01 12 *, means that the message will begin at 22:00 on December 1 playing all
days of the week.
<!ELEMENT end (#PCDATA)>
Contains end timecode as text string. The format is equal to the begin node.
<!ELEMENT ttl (#PCDATA)>
If present, means the element should have <ttl> enabled.
Note: TTL must also have been enabled for the carousel in Viz Ticker Wizard.
<!ATTLIST ttl action CDATA #REQUIRED>
• Attribute “action” defines the the ttl action. Can be either "remove", "pool", or
"inactive".
• Contains ttl value as text string. Must be a whole number (integer).
<!ELEMENT template (#PCDATA)>
The name of the ticker template to use. See the carousel list in Viz Ticker Wizard
for a list of valid template names.
<!ELEMENT gui-color (#PCDATA)>
HTML-style color format. Defines if an element should appear in Viz Ticker Client
with a specific row background color, for example #00FF00 (green).
<!ELEMENT attributes (attribute*)>
If non-standard attributes must be specified for special integration purposes,
they can be defined in the <attributes> node.
• Contains any number of <attribute> nodes.
<!ELEMENT attribute (#PCDATA)>
<!ATTLIST attribute name CDATA #REQUIRED>
Specifies an element attribute, for example <attribute name="this">that</
attribute>.
• Node attribute "name" is the name of the element attribute to define.
• Contains element attribute value as a text string.
Note: Although it is possible, it is not recommended to use the Time To Live (TTL)
attributes when feeding a ticker carousel from Viz Ticker Feed. When feeding a
carousel with elements that include the TTL actions remove or pool, the changes
made by these actions, are overwritten by Viz Ticker Feed during the next update
124
Chapter 11: Viz Ticker Feed
that occurs after a feed XML change or Viz Ticker Feed restart. Manually setting an
element as inactive or moving it to the pool in Viz Ticker Client will likewise be
overwritten during the next update.
The Carousel Overview illustrates the connection between the elements in Viz
Ticker Client, the data in the XML file, and the plug-in setup in Viz Artist.
Chapter 11: Viz Ticker Feed
125
Figure 139: Carousel Overview
Note: Control Material acts a bit different than other control plug-ins. While other
plug-ins use field identifier for setting the value, Control Material uses
fieldid.material:
<field name=”2.material”>MATERIAL*ABC</field>
126
Chapter 11: Viz Ticker Feed
Note: When using Viz Ticker Feed to feed data from a file on disk to a Control Image
plug-in, make sure to use forward slashes and not backslashes when defining the
path, or the file will not be found. Define the path like this:
<field name="6">d:/data/tmp/thumb125.jpg</field>.
Note: Fields containing a '.' in the middle of the text will not be part of the auto
generated description. This has been done to prevent fields like 25.kerning or
35.rotation, which generally is not very descriptive, to pollute the auto description.
11.4
Viz Ticker Feed Troubleshooting
This section describes the most common problem areas that arise when working
with Viz Ticker Feed.
• Q - Is the XML data visible from Viz Ticker Client when it is coming in? For
example, can they open the client and look at the XML fed data?
• A - Yes, the XML data is visible like all other elements. It is recommended to
make the feed set a specific GUI color on the messages from the feed source,
so that they are distinguished from the rest of the (manually created)
messages.
• Q - Is it possible to change data coming from the XML in Viz Ticker Client? Will
it be overwritten if reloaded from the XML?
• A - The messages can be opened, viewed, and also modified in Viz Ticker
Client, but there is no point changing the data manually as the messages will
be overwritten on the next Viz Ticker Feed update.
• Q - Can data be directed to the pool in Viz Ticker Client instead of going
straight on-air?
• A - Yes, but be aware that if elements are directed to the pool from Viz Ticker
Feed, and then manually moved to the carousel, a new instance of each
element will be re-created in the pool on the next Viz Ticker Feed update.
Chapter 11: Viz Ticker Feed
127
12 Viz Playlist Synchronizer
Viz Playlist Synchronizer is an application that synchronizes elements of specified
ticker carousels on two Media Sequencers, one live and one backup. This makes it
possible to do a failover to the backup environment if the live machine should fail.
This chapter contains information on the following topics:
•
•
•
•
12.1
Synchronizing Information
Setting up a Synchronous Environment
Main Window
Synchronizing when Live Indicator is Enabled
Synchronizing Information
The following information is synchronized on system startup and during a
session:
• New elements in carousel
• Modified elements in carousel
• Element name
• Element template
• Element activation status on one or more output channels
• Element start and end times
• Element data
The following information is synchronized on system startup, but not updated
during a session as it generates a lot of traffic:
• Number of runs for each element
• Time to live for each element
The following information is never synchronized:
• Elements in pool
12.2
Setting up a Synchronous Environment
The ticker system must be set up identically on both Media Sequencers before the
synchronizing starts.
The easiest way to create an identical environment is to set up the system on the
main machine, and then copy the default.xml file to the backup machine. The
.xml file is typically located here:
%ProgramFiles%\vizrt\Media Sequencer
Viz Playlist Synchronizer can be run on any machine that has a network
connection to both Media Sequencers. To minimize memory usage, it is not
128
Chapter 12: Viz Playlist Synchronizer
recommended to run it on the live system. Instead it should run either on the
backup system or preferably on a separate machine. If the synchronizer
application must run on the live system, make sure that its priority is set lower
than the priority level of the Media Sequencer.
To set up the connection, perform the following steps:
1. Make sure that the default.xml file is available on both Media Sequencer
machines.
2. Launch the Viz Playlist Synchronizer application from Start > All Programs >
Vizrt > Viz Playlist Synchronizer Feed > Viz Playlist Synchronizer Feed.
This will create content for the .ini file.
3. Close the Viz Playlist Synchronizer application.
4. Open the .ini file from Start > All Programs > Vizrt > Viz Playlist Synchronizer
Feed > Config file.
Figure 140: Viz Playlist Synchronizer .ini File
5. Edit the carouselsync.ini file settings:
• playlists - Defines one or more playlists (ticker carousels) that should be
synchronized. To separate the playlists, use comma.
• output_channels - Defines one or more output channels that the active/
inactive status should be synchronized for. To separate the output channels,
use comma.
• source_host - Defines the IP address of the source Media Sequencer machine.
Note: Source normally refers to the live system, and target normally refers to the
backup system. The distinction is not critical though, as the synchronization
direction can easily be modified in the Viz Playlist Synchronizer GUI.
•
•
•
•
source_port - Defines the port of the source Media Sequencer machine.
target_host - Defines the IP address of the target Media Sequencer machine.
target_port - Defines the port of the target Media Sequencer machine.
loglevel - Defines the log level for the synchronization process:
• CRITICAL - Logs critical errors
• ERROR - Logs all errors + CRITICAL
Chapter 12: Viz Playlist Synchronizer
129
• WARNING - Logs warnings + ERROR + CRITICAL
• INFO - Logs informational messages, such as progress + WARNING +
ERROR + CRITICAL
• DEBUG - Logs debug messages + INFO + WARNING + ERROR + CRITICAL
• TRACE - Logs everything, including log messages from Viz Client Side
Library.
Tip: The most commonly used values are ERROR, INFO, and DEBUG.
6. Start the Viz Playlist Synchronizer application again.
The system will then synchronize the content on the Media Sequencers according
to the configuration in the .ini file.
12.3
Main Window
At system startup, the Viz Playlist Synchronizer Main Window appears on the
screen.
Figure 141: Viz Playlist Synchronizer Main Window
The upper part of the window illustrates the two defined Media Sequencer
machines and the current status of the synchronization process.
Starting the Synchronization Process
To start the synchronization process, click one of the buttons labelled with
<hostname>:<port>, which reflects the settings in the .ini file. Once the
synchronization is running, the illustration at the upper part of the window will
reflect an Ongoing Synchronization Process.
130
Chapter 12: Viz Playlist Synchronizer
Figure 142: Ongoing Synchronization Process
Stopping the Synchronization Process
To stop the synchronization process, click the STOP button.
Opening the Log File
To open the Viz Playlist Synchronizer Log Window, click the View Log button.
Figure 143: Viz Playlist Synchronizer Log Window
The messages in the log file reflects the log level defined in the Viz Playlist
Synchronizer .ini File.
Note: DEBUG and TRACE messages will not appear in this window.
12.4
Synchronizing when Live Indicator is Enabled
The Live Indicator is a feature available from Viz Playlist Synchronizer version 1.1
and above. This feature controls the synchronizer by comparing the values of /
state/live_indicator on the source and target Media Sequencers according to the
Live Indicator States table:
Table 2: Live Indicator States
Source LI State
Target LI State
Synch Direction
any
unknown
stop
unknown
any
stop
on
on
stop
off
off
stop
on
off
source -> target
off
on
source <- target
Chapter 12: Viz Playlist Synchronizer
131
For synchronizing to be enabled, the indicator must be ON on one Media
Sequencer and OFF on the other. All other combinations disable the
synchronization. ON means that this system is live. The default for this setting is
not to be set at all (unknown).
The Live Indicator can be enabled in Viz Ticker Wizard, see Enabling the Live
Indicator.
When the Live Indicator is enabled, manual control of the Viz Playlist Synchronizer
is disabled, and a message appears explaining this. If a machine set up with Live
Indicator is the synchronization target (not live), Viz Ticker Client will show a red
warning in the status bar. If a machine is set up with Live Indicator and the
synchronization is not running (because the Live Indicator is either unknown or
identical on both Media Sequencers), a yellow warning will be displayed in Viz
Ticker Client’s status bar.
132
Chapter 12: Viz Playlist Synchronizer
13 Ticker Service
Ticker Service is a component responsible for storing and controlling the
sequence of ticker messages in Viz Ticker3D. This component is necessary in
order to run a scrolling carousel in Viz Ticker3D.
Ticker Service is distributed as part of the Ticker Viz 2.x Plugins and Ticker Viz
3.x Plugins packages.
The service is installed as an executable in the Viz folder, and the file is labelled
viz_ticker.exe.
Example: If Viz is installed at the default location, the Ticker Service file can be found
at C:\Program Files\Vizrt\Viz3\viz_ticker.exe.
This chapter contains information on the following topics:
• Starting Ticker Service as a Service
• Starting Ticker Service as Console Application
• Ticker Service Options
Starting Ticker Service as a Service
In order to start Ticker Service as a service, perform the following steps:
1. Make sure that the Windows service is installed by running:
C:\Program Files (x86)\Vizrt\Viz3>viz_ticker.exe --Service
2. Then start the service from the command line:
C:\Program Files (x86)\Vizrt\Viz3>net start VizTicker
The VizTicker service is starting.
The VizTicker service was started successfully.
Tip: It is also possible to start Ticker Service as a service by using the Microsoft
Management Console.
Starting Ticker Service as Console Application
In order to actually see the actions of this service, it is possible to launch Ticker
Service as a console application, by performing the following step:
• Click Start > All Programs > Vizrt > Viz Ticker3D > Start Ticker Service in
console.
Tip: It is also possible to start Ticker Service as a console application by using the
command line.
Chapter 13: Ticker Service
133
13.1
Ticker Service Options
By running viz_ticker.exe with --help as an argument, all Ticker Service Options
will be listed.
Table 3: Ticker Service Options
134
Options
Behavior
--help
Shows the Ticker Service help message that
lists all these options
--log-level arg (=50)
Defines the log level to use, a value in 0-100
--port arg (=6301)
Defines the port to bind the socket interface to
--ignore-inactive-uhgroups
Ignore inactive UpdateHub groups, groups that
have a field called active with value 0 will be
ignored
--RegServer
Register Ticker Service to run as a server in a
console
--UnregServer
Remove the Ticker Service from the registry,
only valid when Ticker Service is registered as a
server
--Service
Register Ticker Service to run as a service
--elevated
Used internally by Ticker Service on Windows
Vista to indicate whether Ticker Service has
elevated privileges or not. This parameter
should not be set by the user.
Chapter 13: Ticker Service
14 Presentation Files
When creating messages in Viz Ticker Client it is possible to use presentation files
instead of the default message editor.
Presentation (.vtw) files are created in Viz Template Wizard. From Viz Ticker
Wizard, it is possible to add a presentation file to each template when setting up
the carousel in one of the Wizards. The presentation file replace the Data Frame
and Date/Time Frame in the Elements Editor.
Presentation files must be placed at the following location:
C:\Program Files\Vizrt\Viz Ticker Client\presentations\MyPresentationFile.vtwc.
This chapter contains information on the following topics:
• Preparing a Scrolling Carousel for Presentation File Creation
• Creating a Presentation File in Viz Template Wizard
Preparing a Scrolling Carousel for Presentation File Creation
A .vtw template must be based on a scene containing only the template. For
flipping carousels, this is not a problem as the background and template scenes
are created separately. For scrolling carousels, the background and templates are
designed within the same scene. This makes it necessary to create new scenes
holding only the container structure of each template. If creating a presentation
file for a scrolling carousel, perform the following steps:
1.
2.
3.
4.
Start Viz Artist.
Open the scrolling carousel scene.
Create a copy of the scene, and call it MyTemplate.
In the new scene, remove all containers except the ones belonging to the
template (or the first template if the scene contains more than one template).
Note: Remove the ticker_templates root container, all other root containers (with
subcontainers), and also any subcontainers of ticker_templates that does not belong
to the first template.
5. Repeat steps 2-4 for all templates if the scene contains more than one
template.
Creating a Presentation File in Viz Template Wizard
To create a ticker presentation file in Viz Template Wizard, perform the following
steps:
1. Start Viz Template Wizard.
Note: Viz Template Wizard becomes available when installing the Viz Content Pilot
package.
2. From the Main menu, click File.
Chapter 14: Presentation Files
135
3. From the menu that appears, click Wizard.
4. From the Wizard window that opens, navigate to the template scene.
Note: A .vtw template must be based on a scene containing only the template. For a
scrolling carousel, a separate template scene must be created, see Preparing a
Scrolling Carousel for Presentation File Creation.
5.
6.
7.
8.
9.
Double-click the template scene.
Click the Next button.
Select the elements that should be included in the .vtw template.
Click the Finish button.
Back in the Main window, rename and drag the elements so that they suit the
desired layout.
10. Re-size the template so that it fits the content.
If the template is too big to fit the Elements Editor in Viz Ticker Client, scroll bars
will appear.
11. From the Main menu, click File.
12. From the menu that appears, click Save to file.
13. In the Save Templates window that opens, give the template a descriptive
name, for example MyPresentationFile.
14. Click the Save button.
For detailed instructions on how to operate Viz Template Wizard, see the Viz
Template Wizard User’s Guide.
For instructions on how to add the .vtw file to a template, see Selecting the
Presentation File for a Template.
136
Chapter 14: Presentation Files
15 Keyboard Shortcuts
The following keyboard shortcuts can be used to operate Viz Ticker3D.
Table 4: Keyboard Shortcuts in Viz Ticker Wizard and Viz Ticker Client
Function
Key + Mouse Combination
Selects the next tab in the Main Menu
CTRL+TAB
Table 5: Keyboard Shortcuts in Viz Ticker Client’s Pool Frame
Function
Key + Mouse Combination
Activate the Find text box in the Pool
Search Area
CTRL+F
Copy currently selected messages
CTRL+C
Cut currently selected messages
CTRL+X
Delete currently selected messages
DEL
Opens a new message in Elements
Editor based on the default template
CTRL+N
Opens the Select Template dialog box,
where any available message template
can be selected
CTRL+T
Paste messages
CTRL+V
Select all messages
CTRL+A
Table 6: Keyboard Shortcuts in Viz Ticker Client’s Carousel Frame
Function
Key + Mouse Combination
Activate the Find text box in the
Carousel Search Area
CTRL+F
Activates currently selected messages
INS
Deactivates currently selected
messages
CTRL+INS
Delete currently selected messages
DEL
Copy currently selected messages
CTRL+C
Cut currently selected messages
CTRL+X
Paste messages
CTRL+V
Chapter 15: Keyboard Shortcuts
137
Function
Key + Mouse Combination
Select all messages
CTRL+A
Table 7: Keyboard Shortcuts in Viz Ticker Client’s Elements Editor
138
Function
Key + Mouse Combination
Saves the current element
CTRL+S
Chapter 15: Keyboard Shortcuts
16 Troubleshooting
This chapter of the document describes the most common problem areas that
arise when working with Viz Ticker3D:
•
•
•
•
16.1
System Does Not Detect Scroller Plug-In in Scene
Not Possible to Scan New Scene
Change Scene Name in Viz Ticker3D
Scrolling Carousel Messages Not on Air
System Does Not Detect Scroller Plug-In in Scene
• Q - I have scanned a scrolling carousel scene, but the system does not detect
the Scroller Plug-In in the scene.
• A - First, make sure that the scene is properly designed, see the design
conventions section of the Viz Ticker3D designer’s guide. If you are sure that
the scene is designed correctly, make sure that the additional Ticker Viz
Plugins package has been installed on the Viz Engine machine. The Scroller
Plug-In is part of this plug-in package, and the system cannot detect a
scrolling carousel scene without this package being installed.
16.2
Not Possible to Scan New Scene
Figure 144: Scanning Error Message
• Q - I want to scan a new scene, but the system prevents me from doing this
and the error message above appears: “It is not possible to change the
background scene of an existing ticker system. To use another background
scene, you must start over and delete the current system.”
• A - In order to scan a new scene, any existing setup must be deleted. To do
so, first delete the current carousels from the Ticker Carousels Panel. Next,
delete the current output channels from the Output Channels Panel. Finally,
select and scan the scene again.
Chapter 16: Troubleshooting
139
16.3
Change Scene Name in Viz Ticker3D
• Q - I want to replace the graphics in the existing ticker setup with graphics
from another scene. Is it possible to change the scene name for the setup?
• A - No, it is not possible to change the scene name for an existing ticker
setup. Instead, rename the new scene in Viz Artist so that it overwrites the
existing setup scene.
16.4
Scrolling Carousel Messages Not on Air
Figure 145: Ticker Service Error Message
• Q - I am trying to send scrolling carousel messages to air, but the messages
are not appearing as expected. What am I doing wrong?
• A - This can be caused by various errors, such as not designing scenes
according to the ticker conventions, but the most common reason is that
Ticker Service is not running. To check if this is the case, take a look in Viz
Ticker Client’s Handler Settings Frame. If the error message above appears,
Ticker Service is not running. The service can be launched from Start > All
Programs > Vizrt > Viz Ticker3D > Start Ticker Service in console.
16.5
Message Spell Checking not Possible
Figure 146: Spell Checking Error Message
• Q- I want to spell check a message in Viz Ticker Client, but the system
prevents me from doing this and the error message above appears: “Cannot
140
Chapter 16: Troubleshooting
find the proofing tools for {p3}{k}. Check your Office Language Preferences to
see if the required proofing tools are installed...”
• A - The Viz Ticker Client spell check function is based on the Microsoft Office
dictionary, and uses the default language in Microsoft Word. If the message
above appears, the language settings is not configured correctly, or Microsoft
Office might not be installed on the machine at all.
Chapter 16: Troubleshooting
141
142
Chapter 16: Troubleshooting
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising