PREFACE

Dataton WATCHOUT ® software and this introduction © Copyright 2023 DATATON AB (“Dataton”). All rights reserved.

Dataton, the Dataton logo, WATCHOUT and WATCHPAX are registered trademarks of DATATON AB. All other company and product names are trademarks or registered trademarks of their respective owners. Use of a term in this publication should not be regarded as affecting the validity of any trademark.

Dante is a registered trademark of Audinate Pty Ltd.

NOTCH is a registered trademark of 10 bit FX.

The information in this guide has been carefully checked and is believed to be accurate.

However, Dataton assumes no responsibility for any inaccuracies or errors in this manual or the products described. In no event will Dataton be liable for direct, indirect, special, incidental, or consequential damages resulting from any defect or omission in this manual, even if advised of the possibility of such damages. The technical information contained herein regarding features and specifications is subject to change without notice. Products or manufacturers mentioned do not constitute a recommendation or endorsement by Dataton.

User forum https://forum.dataton.com

Knowledge Base https://knowledge.dataton.com/knowledge

If you have an issue and need to contact the support department, please visit the Help Center and submit a support ticket. https://www.dataton.com/helpcenter

Document version 7.4.1 rev 01, 2024-09-16

Summary

WELCOME TO WATCHOUT

Preface

• Table of Content

• The Basics

• Setup

• Show

  • Show Properties

• Stage & Displays

  • Stage
  • Stage Properties
  • Displays
  • Display Properties
  • Virtual Displays

• Assets & Asset Manager

  • Asset Manager
  • Asset Properties
  • Formats & Codecs
  • Web User Interface

• Timelines & Cues

  • Timeline
  • Timeline Properties
  • Timelines
  • Cue
  • Cue Properties

• Effects

  • Tween Points
  • Position Effect
  • Position Tween Points
  • Chroma Key
  • Key & Fill

• Devices & Nodes

  • Devices
  • Node Properties

• Capture

  • Capture Properties

• Variables & Expressions

  • OSC Variable
  • DMX Variable
  • MIDI Variable
  • LTC Input
  • Variable as Cue
  • Variable Property
  • Expressions

• Outputs

  • String Output
  • Art-Net Output
  • Art-Net GDTF Output
  • Art-Net Recording Output

• 3D

  • Models
  • 3D Mapping

• Audio

  • Audio Devices
  • Channel mapping

• External protocol

  • WATCHOUT 7
  • Legacy Protocol
    • Changed Commands

• Color

  • Overview
  • Compression
  • Pipeline

• Appendices

  • Keyboard Shortcuts
  • XBox Controller
  • Network
  • Hardware Recommendations
  • Autostart
  • Setting up your server

• Quickstart

• Glossary

  THE BASICS

  Producer is a desktop application that lets you transform your creativity into WATCHOUT shows. The goal with this chapter is to give you an overview of Producer along with a brief introduction to some fundamental concepts.

  WELCOME SCREEN

  When you start Producer you will be greated with a welcome screen which allows you to open existing shows or create new ones. You may also connect to an already running show.

  

  • New Show creates a new show on the Director currently in use. If no Director is currently being used by Producer a new show on the local node will be created.
  • Open Show opens the selected show and tries to connect to the Director and Asset Manager that was used when the show was saved.
    • Open Recent lists shows that you recently worked on.
  • Connect opens a dialog allowing you to select the Director you want to connect to. The show on the selected Director will be loaded in Producer.
  • Learn More opens a page where you can learn more about the products and services that Dataton provides.

  You can learn more about the Director, Runner(s) and the Asset Manager in the setup chapter.

  WINDOWS

  All WATCHOUT windows reside inside a desktop window, indicated with the WO icon and the word Producer. You can resize the desktop window by dragging any of its outer borders or corners. Minimize or maximize it using the buttons in the upper right corner. Clicking the close box is equivalent to choosing Quit on the File menu.

  Move a WATCHOUT window by dragging its title bar. Resize a window by dragging any of its corners or outer borders.

  When you open the Producer, you will see a number of windows.

  

  1. The Stage window shows the display areas and a preview of the presentation.
  2. The Properties window is context-dependent and in this initial layout shows the show properties.
  3. The Assets window lists all media used in your presentation.
  4. The Timelines window lists the timelines used in the show.
  5. The Devices window gives info on the devices on your network.
  6. The Main Timeline presents the layers, cues and effects in the show

  Windows are opened or re-opened through the Window menu. Double-click on a timeline in the Timeline window to open its window.

  WINDOWS LAYOUTS

  Window layouts can be reset, saved and loaded from the Layout submenu of the Window menu.

  To save a layout, choose Layout from the Window menu and select Export.... Enter the file name, select the location and save.

  To load a layout, choose Layout from the Window menu and select Import.... Locate the saved layout on your computer and select Open.

  To reset the layout to the default layout (as seen when creating a new show), choose Layout from the Window menu and select Reset. You can also reset the layout by holding the Alt key and pressing the 0 key.

  You may also use shortcuts to jump between different layouts. You can save your current layout by holding Ctrl+Alt key and pressing a digit key (1 - 9). To load a pre-saved layout, hold the Alt key and press the digit (1 - 9) associated with the layout you want to load.

  STAGE WINDOW

  The Stage window is where you set up your presentation layout and add your display devices.

  If you are new to WATCHOUT, think of the Stage as a large canvas, where you can add media files – video, still images, audio files and various input and output items. Displays, whether physical such as an output from a graphics card on the display server, an NDI output from the display server, a virtual display or a 3D projector can all be regarded as windows on that content.

  

  ASSETS WINDOW

  This is where your media files are available to use. Media files are not loaded into the WATCHOUT show file, but are stored in the Asset Manager which makes them available for the media servers and the Producer for programming. In previous WATCHOUT versions the Assets window was known as the Media window.

  

  TIMELINES WINDOW

  This is where the media files are placed and played back. A Timeline is linear, playing back content over time from A to B. WATCHOUT supports multiple Timelines which run simultaneously if required.

  

  The Main Timeline is shown by default when you first open the Producer and you can choose to keep it visible, rename it, hide it or delete it. You can easily add new timelines to suit your show setup under Timeline on the top menu and the Timelines window menu.

  

  DEVICES WINDOW

  This is a new feature in WATCHOUT and lists all available nodes in the WATCHOUT ecosystem. From this window, you can enable services such as Producer or Asset Manager as well as adding displays, audio devices (such as Dante®) or an NDI® video source.

  You can learn more about devices here.

  

  PROPERTIES WINDOW

  The Properties window is context-sensitive and displays information related to the window or item that is currently selected. For example, if you click on a file listed in the Assets window, the properties of that file will be displayed in the Properties window (Name, Type, Frame Rate, etc). if you click on a timeline in the Timelines window, timeline properties will be displayed (Name, Duration, and any Triggers that have been applied, etc).

  SHOW PROPERTIES WINDOW

  When this window is active you can set the frame-rate for your WATCHOUT show and enable automatic update of media assets.

  

  ACTIVATING NODES

  You have to activate the various sevices (Director, Asset Manager, etc) before you can start to make your show. The Producer will discover the nodes available on the network. In the example below, there is a single node called Producer (the PC that is running the WATCHOUT software). The PC had this name assigned in Windows but you can also assign a name in the Device Properties window. Please note that the system will need to be restarted in that case.

  

  To activate the various nodes, go to the Devices window and right-click on the relevant node – in this case Producer.

  

  Click on Use Director. The services list in the Device Properties window will show it has become active.

  

  Now do the same for the Asset Manager.

  

  In the screen above, we have added more nodes to the WATCHOUT system. Note that WATCHOUT network discovery now finds a node running the WATCHOUT software with an IP address in a different range.

  You can assign roles by right-clicking on a node.

  SETUP

  The purpose of this chapter is to give an overview of how you can set up a show using WATCHOUT. You will learn about concepts like how the Producer, Asset Manager, Director and Runner(s) interact with each other. The intention is that you should get a better understanding of what each WATCHOUT component does and give you a vocabulary when working with WATCHOUT. Here is a brief intro to each component:

  • Producer is main application where creators build and edit WATCHOUT shows.
  • Services:
    • Asset Manager - Prepare, organize and share assets such as image, video, audio etc.
    • Director - Directs the show and deliver show updates to the Runner(s) (media server(s)) used during playback.
    • Runner - Plays a show by reacting to playback instructions from the Director. There is one Runner per media server.

  OVERVIEW

  

  BASIC SETUP

  1. Start Producer.
  2. You will be greeted by the Welcome screen.
     • Click New Show to create an empty show. This will also start a Director on the same node that you are currently running Producer on.
  3. Locate the Devices window.
     • In the right pane there is a list of available nodes on your network. Note that one of the nodes is colored pink. This means it is running on your local machine.
  4. Next, start an Asset Manager on your local node.
     • Right-click your node in the Devices window and select Use Asset Manager.
     • The Assets window should be populated with the assets you currently have loaded on your node.
  5. Add assets to the Assets window by dragging and dropping them in the window.
  6. Create a cue by dropping an asset onto a timeline.
  7. Create a display by right-clicking on your node in the Devices window and selecting Add Display.
     • Move the display so it covers the cue.
  8. If you were to enable this display, by clicking the heart icon in the Display Properties it would start a Runner on your node and output the cue you just placed inside the display.

  NOTE: If you enable the display on the same node as you are running the Producer, and you only have one screen connected, you might by mistake cover the entire screen making it impossible to access the Producer window.

  

  FAQ

  Q. Can multiple users edit a show simultaneously?

  A This is currently not supported, but the intention is to work on this for future releases.

  Q. I have a show, MyShow, that is currently directed by DirectorA (on node MachineA). In the Devices window I select MachineB, right-click and select “Use as Director”. What will happen?

  A. The following will happen:

  • DirectorA will continue to play MyShow.
  • MyShow will be pushed to “Director B” (on “Machine B”).
  • Note: If MyShow has any enabled displays when this happens it means you will end up with multiple directors trying to push show updates to the same Runner. One way to avoid this is to go to the Devices window, right-click on MachineA and select “Clear Show from Director”.

  Q. Can I run shows using WATCHOUT on a public network?

  A. We strongly encourage you to stay on a secure private network when creating and playing shows.

  Q. Do WATCHOUT support the use of multiple Asset Manager(s) when creating a show?

  A. No, this is currently not supported. Use a single Asset Manager when creating a show.

  SHOW

  Throughout this User's Guide you see the word "show" many times. When you see it you can think of it as the end result and data carrier of what you create in Producer.

  When you save your work in Producer you will create a Watchout Show (.watch) file that contains information about all the timelines, cues, effects, displays etc that you have defined for your show. One thing that is not saved as part of this file is the actual assets, since this would make the show files huge. Instead Producer stores unique IDs for the assets, used in the show, which allows WATCHOUT to retrieve the asset data from the Asset Manager. This means that you need to keep track of two things to be able to load a show that you previously created:

  • The show file.
  • The Asset Manager data that is referred to by the show file.

  SHOW PROPERTIES

  In this chapter you will learn about the available Show Properties.

  GENERAL

  This section allows you to control some high level settings of the show.

  

  • Frame Rate defines the number of frames used per second during show playback.
  • Eye Point defines the eye point, used to create the view frustum for all displays in the show.
    • The eye point also affects the Default camera mode in Stage with the intent to make it WYSIWYG.
  • Automatically Update Assets can be toggled on to have changes made to original asset files automatically update the assets used in the show.
    • For instance, if you add a my_image.png to the show and then change the my_image.png in another program, you can have these changes trigger a new version of the asset being created.
  • Genlock SDI can be toggled on to use a black burst signal to sync all the nodes used in the show. For this to work you need to connect a master signal source to the nodes that you want to sync.
  • Default Cue Anchor defines the default anchor point for all new cues.

  HARDWARE SYNC GROUPS

  While WATCHOUT’s software-based synchronization across multiple nodes is generally sufficient, there are some cases when frame-accurate synchronization of display refresh cycles is required.

  This section allows you to create hardware sync groups between machines for scenarios where exact sync between nodes is crucial.

  Examples of hardware-assisted synchronization solutions include:

  • NVIDIA Quadro G-Sync II, when used in conjunction with select NVIDIA Quadro graphics cards.
  • ATI FirePro S400 Synchronization Module, when used in conjunction with select AMD FirePro graphics cards.
  • WATCHPAX 60 (model C) with synchronized SDI outputs.

  NOTE: When using AMD graphics, you need the synchronization module to accomplish frame accurate synchronization even within a single graphics card. This is generally not the case when used with NVIDIA graphics.

  

  • Add Group can be clicked to create a new sync group.
    • Once you have given a name to the sync group you can choose the nodes that you want to be part of the sync group.
    • The nodes that are part of a hardware sync group require a special sync card to use this feature.
    • You can use daisy chaining to sync multiple nodes with each other.

  STAGE & DISPLAYS

  In the world of WATCHOUT, Stage is a canvas and displays are windows onto that canvas.

  • Each display server has a total pixel output of 8 x DCI 4k (8 x 4096 x 2160 pixels).
  • A display server may utilize multiple GPUs to display content on multiple outputs.

  By adding a display to Stage, you are effectively associating a physical output from a graphics card. It could for instance be a:

  • Displayport output on a WATCHPAX 62S.
  • SDI output on a WATCHPAX 62C.
  • NDI output from a WATCHPAX 62B.

  

  STAGE

  The Stage window in Producer has two main purposes:

  • Preview the show.
  • Edit the show.

  Below we outline some important concepts related to Stage. You may also read more about Stage Properties here.

  COORDINATE SYSTEM

  Stage uses a right-handed coordinate system with a horizontal X-axis (red), a vertical Y-axis (green), and the Z-axis representing depth (blue). It is possible to visualize the coordinate system by holding your right hand in front of you. Hold your hand so that the thumb points to the right, your index finger points up and the middle finger points towards you. These three fingers then represent the x-, y- and z-axis where the:

  • Thumb points along the positive x-axis.
  • Index finger points the along positive y-axis.
  • Middle finger points the along positive z-axis.

  MENU

  You can access the Stage menu from the top left corner of the window. It can also be found at the top menu bar of Producer under Stage.

  

  • Add Display creates a new display.
  • Add Virtual Display creates a new virtual display.
  • Add 3D Projector creates a new projector.
  • Create Display Grid opens a dialog allowing you to add multiple displays in a single operation.
  • Frame All Displays will change the scale of Stage so that all displays become visible.
    • Note that this does only work in Default mode.
  • Frame Selected Displays works like Frame All Displays but only by using the displays currently selected.
  • Scroll to Origin resets the view to the default location.
  • Camera Mode opens a sub menu allowing you to switch between different camera modes.
  • Close the Stage window.

  EDIT MODES

  There are two edit modes in Stage:

  • Display Edit Mode.
  • Cue Edit Mode.

  You can toggle between the edit modes by clicking the top bar in Stage. Notice that the color of the top bar changes depending on which edit mode you are in.

  In display edit mode you can select and edit displays and in cue edit mode you can edit cues.

  

  CAMERA MODE

  Stage has three camera modes:

  • Default.
  • First Person.
  • Projector.

  Right-click in the Stage window to switch between these modes based on your needs.

  

  DEFAULT CAMERA MODE

  When starting WATCHOUT Producer, the Stage window will be in the Default camera mode. This mode is ideal for creating shows without 3D content, although it still supports 3D editing.

  

  1. Stage Menu.
  2. Stage Scale shows the active Stage scale.
     • Use the mouse scroll wheel or the scale button to change the scale.
  3. Edit Mode can be switched by clicing on the top bar of the Stage window.
  4. Pan the view by clicking and dragging the pan button.
  5. Scale the view by clicking and dragging the scale button
     • Note that you may also scale using the scroll wheel. This zoom operation will scale towards, or away from, where the mouse points.

  

  FIRST PERSON CAMERA MODE

  Designed for 3D tasks such as 3D mapping, the First Person camera mode offers greater navigation freedom compared to the Default mode.

  This view uses a focus point, white sphere, to decide zoom target and what point to orbit around.

  

  1. Pan the view by clicking and dragging the pan button.
  2. Zoom the view by clicking and dragging the zoom button. The camera will zoom towards the focus point.
     • Note that you may also zoom using the scroll wheel. This zoom operation will zoom towards (or away from) where the mouse points.
  3. Orbit the view around the focus point by clicking and dragging the orbit button.
  4. Velocity Control is used to adjust the camera movement velocity.
     • Lowering the camera velocity is epspecially useful during 3D projector position fine tuning.
  5. Axis gizmo is used to move cues and displays in 3D. Click and drag drag an axis arrow (or a plane) to move objects.
     • Notice that the positive direction of the axes are represented with arrows.
  6. Coordinate System origin with axes x (red), y (green) and z (blue).

  

  PROJECTOR CAMERA MODE

  In Projector camera mode, you view the virtual scene from the projector’s perspective. This is useful for projector positioning and calibration.

  You may enter projector mode by either:

  • Clicking on the Frame Display button (magnifying glass), in the Display Properties window.
    or
  • By double-clicking a projector.
    or
  • By right clicking in the Stage window.

  The navigation in this mode mimics the navigation in the First Person mode with the exception that the scroll wheel zooms to target instead of zooming towards a focus point.

  There is more information about the Projector mode in the 3D Mapping chapter.

  

  MOVEMENT & SNAPPING

  There are two ways to change the position of a display or cue:

  • From the Properties window.
    or
  • Inside the Stage window.

  The Properties window will show a section named Position (or Position and Size) once a display or cue has been selected. Note that if you select multiple displays or cues you can edit them in a single operation.

  To move a display, or cue, in the Stage window you need to click and drag it. Keep in mind that you may only select and move objects if you are in the correct Edit Mode.

  If you hold the shift key you will get help lines that simplify movement along a specific axis.

  

  During movement objects will try to snap to each other. The snapping can be toggled on/off from Edit/Snap found in the top menu bar of Producer.

  

  You may tempoararily disable snapping by holding the Ctrl key while moving an object.

  STAGE TIERS

  Stage Tiers are layers in the Stage window. They can be used to restrict media cues, on layers or on timelines. For example, if two overlapping displays are located on the same tier, in the Stage window, WATCHOUT will automatically create a soft edge blend between them. If you want to avoid the edge blend when two, or more, screens overlap in the Stage area, you would put them on different tiers.

  COMPOSITION MODE

  If a Composition's timeline window is active, Stage switches to composition mode. This means that Stage only shows cues that are part of the active composition. To make it clearer that Stage is in composition mode, a frame is added around the Stage window and an icon on the top bar.

  

  KEYBOARD NAVIGATION

  

  STAGE PROPERTIES

  In this section you will learn about Stage Properties which is shown if you click the Stage background.

  FILTER

  In WATCHOUT there is a concept called tiers that allows you to filter what cues are being rendered for a specific display. You may assign one or multiple tiers to displays in the Display Properties and you may do the same for cues in the Cue Properties.

  Before WATCHOUT renders the content for a display it will filter out all cues that do not match the tier configuration of the display. This is easiest to explain with an example:

  • Display A is assigned two tiers, Base and Tier 1.
  • Cue A is assigned Base.
  • Cue B is assigned Tier 1 and Tier 2.
  • Cue C is assigned Tier 2.

  What will be considered as valid content for Display A?

  Cue A and Cue B have at least one tier that matches Display A and are thus considered as valid content. Cue C however only has Tier 2 which is not part of the tier configuration for Display A and thus Cue C is not considered as valid content for Display A.

  The Filter section in the Stage Properties can be used to create new tiers and preview what happens if a tier is not active by toggling its visibility.

  

  • Tiers shows all tiers present in the show.
    • Base is assigned to display and cues on their initial configuration.
      • This tier cannot be removed from the show.
    • Eye icon can be used to toggle the visibility of cues in Stage based on their tiers configuration.
      • It is enough that one of the tiers of a cue is kept visible for the cue to stay visible in Stage.
    • Pen icon can be used to edit the name for a tier.
      • Note that by changing the name of a tier will update all displays and cues that refer to that tier.
    • Thrash can icon can be used to remove a tier.
    • Plus icon can be used to create a new tier.

  APPEARANCE

  This section is used to change the appearance of Stage. You may edit the Stage background by either setting a checker pattern or by defining a custom background color.

  

  • Checker
    • None means that no checker pattern will be rendered in the background.
    • Small means that a small checker pattern will be used as the background.
    • Medium means that a medium checker pattern will be used as the background.
    • Large means that a large checker pattern will be used as the background.
  • Color
    • Can be used to define a custom background color.
    • Note that if a checker background is active this button is disabled.

  DISPLAYS

  In this chapter you will learn about Stage displays and how these can be configured to control how and where the visual content of a show is rendered.

  A Stage display is an object that resides in the Stage window. This object is then associated with a physical display device such as a projector, monitor, LED wall, video wall cube etc to make the show content visible for the audience.

  

  There are three different types of Stage displays in WATCHOUT:

  • Display.
    • Use this type to represent all flat display devices, as well as projectors when projecting onto a flat screen or a curved screen that can be managed by the Warp feature of WATCHOUT.
  • 3D Projector.
    • Use this type when projecting onto a complex, 3D object, represented by a 3D model in WATCHOUT. No automatic edge blending is applied, but manual masking can be used to manage overlapping areas.
  • Virtual Display.
    • Defines a rectangular area in Stage from which you can grab/record the resulting pixels for use as a new media item. This is useful when dealing with displays that have odd resolutions, such as LED wall modules (subsequently managed through an LED wall processor), or to create dynamic textures for mapping onto 3D models.

  When a display is selected in the Devices window or in Stage, the Device Properties window becomes active.

  You can learn more about adding displays and projectors in the Stage chapter.

  DISPLAY PROPERTIES

  In this chapter you will learn about the display properties that can be configured.

  GENERAL

  The General section allows you to edit common data such as Device Name and Device Host.

  

  • Device Name can be set to anything you like. This name is shown in the Stage window when you are in Display Edit Mode.
  • Device Host is used to set the node on which the display content will be rendered.
  • Heart button is used to toggle the activate or deactivate the display.
  • Lock button is used to toggle the possibility to edit the display.
  • Frame button is used to change the scale in Stage so the selected display(s) are in focus.
  • Color button is used to change the frame color of the display. Use it to make it easier to find specific displays.
    • The color is also shown in the Devices Window.

  In order to see any output from a display on a monitor etc you need to enable it. To enable a display you need to:

  1. Select the display.
     • Make sure you are in Display Edit Mode otherwise you cannot select displays.
  2. Assign it to a node by setting the Device Host.
  3. Locate and click the heart icon located in the General section.

  

  PLACEMENT

  The Placement section allows you to edit data related to the location of the display in the Stage window.

  

  • Initial Position can be changed to edit the position of the display.
  • Initial Rotation can be changed to rotate the display counter clockwise around the anchor point.
  • Anchor Point defines the origin of the display and it also defines the point around which the display is rotated.
    • The anchor widget, with arrows, can be used to move the anchor point to a specific corner, edge or the center of the display.

  

  • Projector specific settings:
    • Eye defines the point where the projector is located.
    • Target defines the target point of the projector when there is no lense shifting.
    • Orientation defines the rotation around the direction vector.
    • Lense Shift can be used to change where the projector displays its image without changing the position of the projector.
    • Width / Distance Ratio can be used to change the shape of the projection frustum.
    • Note: During the calibration step when doing 3D Mapping a number of the projector settings above are modified.

  In the following example the anchor and rotation of a display is being edited:

  

  PRESENTATION

  The Presentation section allows you to edit the tiers of the display.

  

  • Tiers
    • Show Cues on Stage Tiers can be changed to make the display only render cues that belong to a specific tier.

  OUTPUT

  The Output section allows you to edit settings related to rendering the referred cues to a display device.

  

  • Route
    • Device defines the target buffer for the display. It can be set to GPU, SDI, NDI® and Virtual.
    • Channel defines the display device to render the display content to.
  • Dimensions
    • Resolution is used to define the wanted output resolution. That is the resolution of the buffer to which WATCHOUT renders the cues.
    • Use as Input Resolution can be toggled off to use a custom resolution for the display in Stage.
  • Signal
    • Color Depth defines the number bits used per color channel/component.
    • Color Space defines the color space to use for rendering.
  • Delay
    • Delay frames allows you to delay the rendering of a display. This can be useful to make different displays play exactly in sync.
  • EDID
    • The dropdown will show all EDID assets available in the Asset Manager currently in use.
      • EDID files can be added to the Asset Manager just like any other asset.
    • Capture EDID as Asset button captures the current EDID information as an asset and uploads it to the Asset Manager.
      • This is only supported on NVIDIA Quadro-based GPUs.

  WARP

  Warping can be useful to make the display output follow an irregular surface, like a curved wall.

  

  • Edit Warp button opens a window allowing you to modify the warp mesh onto which cues are rendered.
  • Enable Warp toggles warping on or off.
  • Show Warp Points on Display toggles the rendering of warp points on or off.

  NOTE: You can use a XBox type of controller to adjust the warp points.
  For more information look in Appendices / XBox Controller

  Below we edit the warp mesh to change how the output is rendered:

  

  Before:

  

  After:

  

  MASK

  Masking can be useful in situations where you want to block parts of the display output. For instance, if you have a pillar between a projector and the projection surface you might want to avoid displaying content on the pillar. This can be achieved by using mask(s).

  

  • Automatic Soft Edges allows you to get automatic blending in the areas where displays overlap.
    • Enable toggles automatic soft edges on or off.
      • Only displays that have this feature enabled will contribute to the soft edge solution.
      • It does not matter if the actual display is enabled or not.
  • Custom Mask can be used to block render display outputs for certain pixels.
    • Enable toggles custom masking on or off.
    • Edit button opens a window allowing you to create and modify mask surfaces.
      • The mask layers are local to this display.

  DISPLAY MASK EDITOR

  The display mask editor allows you to add and edit multiple mask surfaces to your display to limit the areas where the display renders pixels. The Display Mask Editor window shows what the display is currently rendering in Stage. This is to simplify positioning the masks you want to use for your display.

  

  WATCHOUT provides a number of predefined mask surfaces that can be added from the Display Mask Editor menu or by right-clicking anywhere in the Display Mask Editor window.

  Once a mask has been added it will be shown in the right column of the Display Mask Editor named Mask Surfaces. It is possible to select multiple masks and edit them together. To do so you may either select them by clicking on their name in the Mask Surfaces column, or you may click or drag select them directly in the mask window.

  There are two edit modes for masks:

  • Edit Surfaces which allows you to edit one or multiple mask surfaces.
    • You can activate this mode by clicking the surface icon found in the upper left corner of the Display Mask Editor.
    • You may move, stretch or rotate one or multiple mask surfaces by interacting with the control points that are shown once one surfaces have been selected.
      • Select one or more mask surfaces by clicking on them in the Display Mask Editor window. Note that you can hold control or shift button to modify the select operation. You can also select one or multiple masks with a drag select operation or click on the mask surface you want to edit in the Mask Surface section found on the right of the Display Mask Editor window.
    • You may also change the name of the mask surface to better convey the type of masking it is used for.
  • Edit Points which allows you to edit one or multiple mask surface points.
    • You can activate this mode by either clicking the unfilled surface icon found in the upper left corner of the Display Mask Editor or by double-clicking on a mask surface.
    • You may edit one or multiple points by selecting them.
      • Select one or more points by clicking on them in the Display Mask Editor window. Note that you can hold control or shift to modify the select operation.
      • You can read more about the possible edit operations for points in the Mask Point Properties section.
  • Add Mask Surface allows you to add a mask surface from a list of predefined surfaces.

  Here is a quick demonstration of how to setup masks for your display:

  

  MASK POINT PROPERTIES

  The Mask Point Properties can be used to fine-tune a mask. You can activate it by selecting one or more points when you are in the edit point mode of the Display Mask Editor.

  

  • Alpha Value allows you to define the alpha value for a specific point.
    • If alpha is set to 1 it is completely opaque; if alpha is set to 0 is completely transparent.
  • Make Black button is a shortcut for setting the alpha value to 1, making the point completely opaque.
  • Make Transparent button is a shortcut for setting the alpha value to 0, making the point completely transparent.
  • X Position defines the position along the x-axis in pixels, relative to the lower left corner of the display.
  • Y Position defines the position along the y-axis in pixels, relative to the lower left corner of the display.
  • Control Point Handle widget can be used to select and edit control point handles.
    • Length defines the distance in pixels from the control point to the control point handle.
    • Angle defines the counterclockwise angle between the control point and the control point handle.
      • For instance, if the angle is 0 the point will be located along the local x-axis for the control point.
  • Smooth Junction can be toggled on or off to link or unlink the bezier control point handles.
    • If it is activated it means that the control point handle on the opposite side (of the handle being edited) will also be affected by edit the operation, in order to maintain a smooth curve.

  CALIBRATION

  Set a NDI® Calibration Stream for the auto calibration system to take over the display. The name of the NDI® stream is given by the auto calibration software.

  Assume we want to calibrate two projectors so they produce a continuous image. An auto calibration software then produces a test pattern that is outputted by the two projectors and analyzed by a camera. The auto calibration then makes the necessary changes to align the two projectors so they form a continuous image.

  

  WHITE POINT

  The white point allows you to define what color in the output should be considered as white.

  

  TEST PATTERN

  This property group contains the possibility to change the output of the display to a specific pattern. This can for instance be useful when working with multiple overlapping display devices.

  

  The available patterns are:

  • None, outputs the cues associated with the display.
  • Muted, outputs nothing for the display even if it is active.
  • White, outputs white color.
  • Masked, outputs the masks if any.
  • Pattern, outputs a checker pattern.

  You can also toggle Render Info on and off. This information can be helpful to identify screens if there are many outputs.

  VIRTUAL DISPLAYS

  Just like an ordinary Stage display a virtual display is defined by a rectangular area in which cues can be placed. However, instead of outputting the rendered cues directly to a physical display device, like a monitor, the virtual display renders the cues to a buffer. This buffer can then be used just like a media asset that can be rendered to an ordinary display or projector.

  You can think of this process as the virtual display is recording content and creating a media asset on the fly. The media asset can then be used as a regular cue or as a texture for a 3D model.

  The short clip below shows the following sequence:

  1. Create a virtual display.
  2. Drag the virtual display from the Devices window to the timeline. This creates a cue using what the virtual display is capturing as a media.
  3. Change the position of the virtual display, showcasing that it changes how it records the regular media cue.
  4. Add a 3D model and apply the virtual display to it which means the recorded content will be used as texture.
  5. Change the position of the virtual display, again showcasing how the virtual display output content changes.

  

  ASSETS & ASSET MANAGER

  Earlier versions of WATCHOUT featured the Media window, which listed available content in your show. In WATCHOUT 7, this is now the Assets window. Media files are not loaded into the WATCHOUT show file but are stored in the Asset Manager.

  ASSET MANAGER

  You can think of an asset as a piece of data stored in a file, like image or audio data. The assets used to build a show in WATCHOUT are handled by the Asset Manager. The purpose of the Asset Manager is to:

  • Prepare assets for being used in WATCHOUT shows.
  • Organize assets.
  • Share assets between projects and users.

  The Asset Manager does not need to be located on the machine running Producer, it can be on any node available on your network. Since preparing assets can be a time-consuming and CPU and GPU intensive task, it can be beneficial to share a powerful machine among creators.

  NOTE: You may organize your assets into folders just like any other file system.

  To make use of assets they need to be added to the show. This is done by either dropping them to a Timeline or to the Stage window which creates a cue. This can be used to configure how the data stored in the asset is visualized/played.

  

  • Magnifying glass icon is used to open the search interface.
  • Name will show the name of the asset. This can be edited in the Asset Properties.
  • Image will show a thumbnail of the asset.
  • Dimensions shows the resolution for media and the size for 3D models.
  • Duration shows the time duration of the asset (available for videos and audio).
  • Date shows when the original file was created (this does not show when the asset was added to Producer).

  NOTE: Not all assets have a thumbnail, dimension or duration.

  ASSET TYPES

  WATCHOUT supports the following asset types:

  • Image: .webp, .tiff, .jpg, .png, .psd, .gif, .tga
  • Video: .mp4, .mov, h262, h264, h265, ProRes, NotchLC, Hap.
  • Audio: .wav, .mp3, .mp4, .ogg
  • 3D Model: .obj, .gltf, .glb, .3ds
  • Display settings formats: .mpcdi
  • Composition:
    • A group of assets bundled together.

  You can find more information about formats and codecs here.

  ASSET MANAGER MENU

  The Asset Manager menu looks like this:

  

  • New Folder will open a dialog where you can set the name of the folder you want to create.
  • New Media File will open a dialog allowing you to add an asset.
  • New Image Sequence will open a dialog allowing you to add a sequence (.tiff or .tga).
  • Find Cues for Selection will search for cues referring to the selected assets. More information can be found here.
  • Collapse All Folders will close all open folders.
  • Expand All Folders will open all closed folders.
  • Delete will delete the selected assets.
  • Media Settings will open a dialog allowing you to define how different formats are converted during WATHOUT asset preparation.
  • Export All Assets will open a dialog allowing you bundle all assets in the Asset Manager to a package.
  • Export Selected Assets will open a dialog allowing you bundle the selected assets in the Asset Manager to a package.
  • Import Assets will import a package that was previously exported.  

  ADDING ASSETS

  To add an asset to the Asset Manager you can either:

  • Go to the menu and select New Media File (or New Image Sequence).
    OR
  • Drag and drop a file from your file system to the Asset Manager.

  Once the asset has been added, the Asset Manager will begin to prepare the asset for use in WATCHOUT shows. The asset goes through four steps:

  1. Uploading (only necessary if you are using a remote Asset Manager).
  2. Pending which means it is waiting to be optimized for WATCHOUT usage.
  3. Optimizing which means it is being optimized for WATCHOUT usage.
  4. New which means it is ready to be used in WATCHOUT shows.

  

  SELECTING ASSETS

  You select an asset by clicking on it. Producer also supports holding the Control/Shift-key to alter the select operation. You can also use Control+A to select all assets in the Asset Manager.

  When an asset is selected, the Properties window is populated with asset information - Asset Properties.

  REMOVING ASSETS

  Select an asset(s) in the list and click the Delete key or select Delete in the Asset Manager menu.

  FOLDERS

  Producer supports importing complete folder structures which is very useful if you have already organized your assets in a specific way. To add a folder structure to the Asset Manager simply drag and drop it in the Asset Manager window.

  You can also create or delete new folders from the Asset Manager menu. To move an asset to a specific folder you select and drag it to the folder of your choice.

  SEARCH

  Click on the magnifying glass icon at the top of the Asset Manager to open the asset search interface.

  Enter text in the search field to start your search. You can further narrow down the search result by:

  • Selecting a specific asset type in the drop-down menu.
  • Showing newly created assets (assets marked with a star).
  • Showing assets based on which cues are currently selected on your Timeline(s).
  • Showing assets that are currently being prepared. Please see adding assets.

  Hide the search functionality by clicking on the cross on the far right.

  

  FIND CUES FROM ASSETS

  Sometimes it might be helpful to find cues that are using a specific asset. To do this you need to:

  1. Select the asset(s) of interest.
  2. Right-click in the Asset Manager window and select Find Cues for Selection.
  3. The search result is shown in the bottom part of the Asset Manager window.

  The search result is interactive so you can click on the cue you want to inspect. Doing so will activate the Timeline, that owns the cue and scroll to it. You can also use the down/up button to jump to next/previous in the result. Next to these buttons is a "select all cues" button which is useful if you want to delete all cues referring to a specific asset.
  Note: You can also use the arrow down/up keyboard keys to navigate the list.

  

  MEDIA SETTINGS

  The Media Settings can be accessed from the Asset Manager menu. This opens a dialog allowing you to define how different formats are converted during WATCHOUT asset preparation. This is done by changing the Out format. You can find more information about formats and codecs here.

  

  ASSET PROPERTIES

  The Asset Properties window provides information about the selected asset(s) along with a few possibilities to edit the asset(s).

  VERSION

  An asset can have multiple versions. You can see the version number section at the top of the Asset Properties window. New versions of an asset can be created by modifying the asset in the Customize section of the asset properties or by dropping a new asset in the Asset Properties window. A cue can be set to use the latest version of an asset or a fixed version of the asset.

  

  The Name field will show the original name of the asset but note that you may edit this name.

  Below is information about the asset. The information will vary depending on the selected asset(s) and their type(s). The information section cannot be edited.

  • All asset types:
    • UUID is a universal unique identifier for the asset. When a new asset is added, or a new version of an asset is added, a new UUID is created.
      • Note that you will create two different UUID even if you load the same asset twice.
    • Type contains information about the asset type.
    • Progress is updated while an asset is being prepared for WATCHOUT.
    • It will display "processed size"/"estimated final size" "(progress in percentage)".
      • Note that once the asset preparation is done the "estimated final size" will show the actual size on the storage device.
  • Video:
    • Frame Rate contains the number of frames played per second.
  • Video/Image:
    • Color Space shows the color space used during playback.
    • Dimensions shows the resolution of the asset.
    • Codec contains information on the format used to store the data.
      • Note that it shows information in the form:
        "Original playback format" as "WATCHOUT playback format".
  • Video/Audio:
    • Duration shows the duration of the asset.
  • Audio:
    • Channels shows the number of channels available in the audio.
    • Sample Rate shows the sample rate for the audio.
  • Model:
    • Dimensions shows the size of the original model in the unit that was used when the model was created.
  • EDID
    • Export To... can be clicked to export the specific EDID asset to a file stored on your local disk.

  CUSTOMIZE

  In this section you may customize assets.

  

  • Video
    • Frame rate
    • Color Space
  • Image
    • Color Space
  • Audio
    • Sample Rate

  To create a new version make your adjustments and click Create New Version. Note that if a cue refers to this asset and has its version set to Latest, the cue will automatically use the newly created version.

  

  FORMATS & CODECS

  In this section we will explain some of the most common formats and codecs supported by WATCHOUT.

  It is important to know the difference between a file format and a codec.

  • A file format is a data container with a specific suffix.
  • A codec specifies how the data within the file can be encoded or decoded.

  PNG

  PNG is an image file format.

  • PNG stands for Portable Network Graphics.
  • Uses lossless compression.
  • Supports storing information about transparency in an alpha channel.
  • File suffix: .png

  JPEG

  JPEG is an image file format.

  • JPEG stands for Joint Photographic Experts Group.
  • Uses lossy compression.
  • Does not support storing information about transparency.
  • Widely used.
  • File suffix: .jpg

  PSD

  PSD is an native file format used in Adobe Photoshop.

  • Stands for Photoshop Document.
  • Uses lossless compression.
  • Supports storing information about transparency in an alpha channel.
  • Supports storing multiple layers of graphics in a single file.
  • File suffix: .psd

  GIF

  GIF is an image file format.

  • Stands for Graphics Interchange Format.
  • Only uses 8-bits per pixel.
  • A single GIF file can contain multiple images which together can be played back as a very basic video.
  • File suffix: .gif

  TGA

  TGA is an image file format introduced in 1989 by a company called Truevision.

  • Stands for Truevision Graphics Adapter.
  • Supports storing information about transparency in an alpha channel.
  • Not widely used as of today.
  • Sometimes also referred to as TARGA.
  • File suffix: .tga

  WEBP

  WebP is an image file format developed by Google.

  • Supports both lossy and lossless compression.
  • Supports storing information about transparency in an alpha channel.
  • On average it gives 40% smaller files compared to Jpeg.
  • File suffix: .webp

  TIFF

  TIFF is an image file format.

  • Stands for Tag Image File Format.
  • Uses lossless compression
  • Supports storing information about transparency.
  • Not widely used as of today.
  • File suffix: .tiff

  HAP

  HAP, High Performance Video  Codec, is a family of open-source video codecs. The family contains:

  • HAP provides reasonable image quality. It does not support an alpha channel.
  • HAP Alpha provides the same quality as HAP and supports an alpha channel.
  • HAP Q provides improved image quality at the expense of larger file sizes. It does not support an alpha channel.
  • HAP Q Alpha provides the same image quality as HAP Q and supports an alpha channel.
  • HAP R provides higher image quality than HAP Q (and consequently HAP) and supports an alpha channel. It uses BC7 Texture Compression.

  All codecs above are encoded using a 8-bit color depth.

  H.264 - AVC

  AVC, Advanced Video Coding, is a widely used video compression standard and codec first introduced in 2003. Its successor H.265 (HEVC) offers improvements related to compression quality and support for HDR content.

  H.265 - HEVC

  HEVC, High Efficiency Video Coding, is a video compression standard and codec that offers much greater compression with maintained image quality compared to its predecessor AVC.

  PRORES

  ProRes is an intermediate codec which has visually lossless compression. It was developed by Apple for use in video post-production as a successor to the Apple Intermediate Codec. It is intended for video editing, not end user viewing (thereby intermediate codec) and ProRes is not optimized for media servers.

  NOTCHLC

  NotchLC is a GPU-accelerated video codec designed for both intermediary use and playback. NotchLC provides the equivalent of 10-bit color depth.

  ASSET MANAGER WEB USER INTERFACE

  You can access the Asset Manager directly via the network by using a standard web browser and connecting to the Asset Manager on port 3023.

  WEB ADDRESS

  To access the Asset Manager running on the local computer, type the following in the web browser address field:

  HTTP://localhost:3023
  or
  HTTP://127.0.0.1:3023

  To access the Asset Manager running on a remote computer with the IP-number 192.168.0.100, type the following in the web browser address field:

  HTTP://192.168.0.100:3023

  WEB VIEW

  Once connected to the Asset Manager, you will see a list of all assets and folder in the Asset Manager.

  

  1. Assets list This is a drop-down list with the asset types to be viewed in the web UI. Default is All but any single type of asset can be selected, for example Video, Audio, Image etc.

  
  
  
  
  
  
  
  

  2. Columns This is a drop-down list to select which column to show for each listed item. Multiple columns can be selected for a more customized view.

  
  
  
  
  
  
  
  
  

  3. Search field You can search for an asset in the database by entering a complete word, or part of a word, in its name. You can also search for a specific file extension, for example jpg.

  4. Upload files Clicking on the icon will open a file dialog to add a specific file to the asset database.

  5. Upload folder Clicking on the icon will open a file dialog to add a folder containing files to the asset database.

  6. Create folder Clicking on the icon will create a new folder in the asset database.

  
  

  ADDING AND DELETING ASSETS IN WEB UI

  You can add assets to the Asset Manager in two ways:

  • By clicking the two icons at the top right, Add file or Add folder. Both these buttons will open a file dialog allowing you to select a single file or a folder containing multiple files to be added to the Asset Manager.

  • By selecting the files or folders from a open file window and drag-dropping them to the Asset Manager web UI.

  After the file/folder is added, the files will be optimized and imported to the Asset Manager database and there will be a visible progress bar indicating the status of the import/optimization.

  TIMELINES & CUES

  In this chapter you will learn about what a Timeline is and how you can use cues to populate your Timeline(s) with content.

  

  TIMELINE

  A Timeline is where you place the content that you want to play to your audience. The content, like videos or audio, is defined in assets and by dragging an asset to a Layer on the Timeline you create cue. By selecting a cue on the timeline you can further edit how the referred asset is used in the show. For instance, you may want to change the duration of a video clip or you may want to add an Effect.

  

  1. Name shows the name of the Timeline.
  2. Timeline ID shows the identifier (ID) of the Timeline.
  3. Timeline Time shows where the Time Position Indicator is located.
     • Edit this to jump to a specific time.
  4. Time Position Indicator shows the current time position using a vertical line drawn through the Timeline window.
     • The color of the line indicates the Click Jumps to Time state.
  5. Jump button to jump to where the Time Position Indicator is located on the Timeline.
  6. Active Layer shows a pink vertical bar to convey that this layer is active.
  7. Cue object that can be selected to edit show content.
  8. Effects shows the chosen effects for the selected cue.
     • Use the eye to hide/show a specific effect curve.
  9. Tween Curve allows you to create and edit tween points.
  10. Play button to start tplayback.
  11. Pause button to pause playback.
  12. Stop button to stop playback.
  13. Zoom Out button to zoom out the Timeline view.
  14. Zoom In button to zoom in the Timeline view.
  15. Horizontal Scrollbar to scroll to a specific time in the Timeline view.

  TIMELINE CONTEXT MENU

  There are two context menus in the Timeline window, one for editing the timeline itself and one for working with cues.

  TIMELINE GENERAL CONTEXT MENU

  If you right-click in the Timeline window, without having any cue selected, you will open the general context menu.

  You can also open this menu by clicking on the three horizontal lines in the top left corner of the Timeline window.

  

  • Cue operations:
    • Add Play Control Cue adds a play control cue.
    • Add Pause Control Cue adds a pause control cue.
    • Add Output Cue adds an output control cue.
    • Add Marker Cue adds a marker cue.
  • Layer operations:
    • Insert Layer inserts a layer above the active layer.
    • Add Layer adds an additional layer at the top of the Timeline.
    • Delete Layer deletes an additional layer at the top of the Timeline.
    • Select All Layer Cues selects all cues on the active layer.

  TIMELINE CUE CONTEXT MENU

  If you right-click in the Timeline window, while having one or multiple cues selected, you will open the cue context menu.

  You can also open this menu by clicking on the three horizontal lines in the top left corner of the Timeline window. Again, at least one cue needs to be selected for this menu to be shown.

  

  • Properties activate and show the Cue Properties window.
  • Find Asset tries to find the asset(s) associated with the selected cue(s).
    • The asset(s) found will be selected in the Asset Manager window.
  • Move opens a dialog that allows you to move the selected cue(s).
  • Cut cuts the selected cue(s) allowing you to paste the cue(s) later on.
  • Copy copies the selected cue(s) allowing you to paste the cue(s) later on.
  • Delete deletes the selected cue(s).
  • Effect opens a sub menu allowing you to add or remove effects to the selected cue(s).  .
  • Trim allows you to shorten the duration of the selected cue(s) based on where the Time Position Indicator is located.
    • Start edit the start time of the cue.
    • End edit the end time of the cue.
  • Reset allows you to reset some settings.
    • In-Time.
    • Duration resets the duration of the selected cue(s) to the original duration.

  LAYERS

  A Timeline consists of multiple layers on which cues can be added. When the show is empty you can think of the layers in the Timeline as a stack of fully transparent papers. As you add image or video cues to the layers you will fill these transparent "papers" with pixels. The layer with the highest number represents the top of the "paper" stack which means that cues placed on this layer will render on top of cues placed on layers below it. You may override this behaviour by changing the Stacking on the cue.

  Layers further up the layer stack may occlude cues further down:

  If a cue is selected on the timeline it will be prioritized for movement operations in the Stage window:

  KEYING LAYER

  From the Layer Properties, which you access by clicking on a layer name in a Timeline, you can turn the layer into a keying layer which means that all cues that are present on that layer are used to produce a key. You can think of the key as a filter which is used to mark areas which you want to fill with specific content. For instance, you may place a circular shaped image on a keying layer and have that circle being filled with contents from cues residing on regular layers.

  

  WATCHOUT provides four different types of keying layers. Each type uses a specific pixel property to define how the keying filter is created. Note that the keying layer type only affects the cues residing on the keying layer and tells the system how these cues are interpreted to create the keying filter. The following keying filter types are available:

  • Luma Key means that the luma value of each pixel is used to define the filter.
  • Luma Key (Inverted) means that the inverted luma value of each pixel is used to define the filter.
  • Alpha Key means that the alpha value of each pixel is used to define the filter.
  • Alpha Key (Inverted) means that the inverted alpha value of each pixel is used to define the filter.

  If you define multiple keying layers, even on different timelines, all the cues on these layers are combined into a single keying filter. Each cue will contribute to the keying layer according to the keying layer type active on the layer on which they reside.

  The layer order of the keying layers does not matter, you are free to place the keying layers where it is most convenient to you.

  As outlined above you may use keying layers to define how you mark pixel areas based on their properties, but once you have created these pixel areas you want to define what content you should fill those pixels with. You may read more about how this is done in the Key & Fill section found in the Cue Properties.

  You can read more about this effect here.

  CUE HOVER INFO

  When you hover over a cue some helpful information will be shown in the top of the Timeline:

  

  1. The name of the media applied to the cue.
  2. The Timeline time when the cue starts.
  3. The duration of the cue.
  4. The cue ID.

  CUE OVERLAPS

  When two cues reside on the same layer they may overlap. This is usually an unwanted state so when an overlap has been detected the affected cue objects, in the Timeline, are marked with a striped pattern. This can be resolved by selecting and moving cues until the pattern disappears.

  Not all cue overlaps are forbidden. Media cues may have overlapping cues of the following types:

  • Control cue
  • Output cue
  • Marker cue

  

  There is also another exception where cue overlaps are allowed and that is when you are using Fade-in/out as shown in the video below:

  

  TIME POSITION INDICATOR

  The Timeline Position Indicator shows the current time position using a vertical line drawn through the Timeline window. Its color indicates if the Click Jumps to Time is active. If it is active it means that when a cue is selected the Timeline Position Indicator will jump to the start of the cue.

  The Timeline Position Indicator is drawn as a solid pink line if Click Jumps to Time is active, otherwise it will be drawn as a dashed purple line.

  

  CUE TRIM

  This feature allows you to change the duration and starting/end frame of the referred asset based on where the Time Position Indicator is located. You can think of it as cutting out parts of the start or the end of a video or audio clip. When you trim a cue using Start the In-time property is changed.

  

  TIMELINE PROPERTIES

  In this chapter you will learn about the available Timeline Properties.

  GENERAL

  

  • Name defines the name of the Timeline.
  • Duration defines the duration of the Timeline.
    • This input field supports using a letter to define the unit of the inputed value:
      • s/seconds for seconds.
      • m/minutes for minutes.
      • h/hours for hours.
  • Stacking defines the render order of content from different timelines.
    • Timeline Order uses the order in which the Timelines are listed in the Timelines window window.
    • Always on Top means that the content of this Timeline will render on top of other Timeline(s).
    • Clarification: Always on Top is always rendered on top of Timelines using the Timeline Order. If multiple Timelines are using Always on Top the order in which Always on Top was activated will decide the render order. The Timeline that activated Always on Top most recently will be the topmost Timeline.
  • Auto Run can be activated to make the timeline start playing automatically once the Director has loaded the show.

  TRIGGERS

  

  • Play Expression defines an expression that can trigger play.
  • Pause Expression defines an expression that can trigger pause
  • Stop Expression defines an expression that can trigger stop

  You can read more about expressions here.

  FAQ

  Q. Which Timeline is rendered on top if multiple Timeline(s) uses Always on Top?

  A. If multiple Timelines uses Always on Top the order in which Always on Top was activated for the Timeline will decide the render order.

  • For instance, let us assume you have three Timeline(s) called A, B and C, each with Stacking set to Timeline Order.

    • You set Always on Top for A.
      • This means that A will render on top of B and C. The render order for B and C is still decided by the Timeline Order.
    • Later on you set Always on Top for B.
      • This means that B will now render on top of A (since it was changed after A).
      • Note that A will still render before C since Always on Top is always rendered on top of Timeline(s) using the Timeline Order.

  TIMELINES

  Producer supports having multiple timelines. These timelines are organized in the Timelines window.

  Using multiple timelines can be useful in a number of situations, for instance if you want to play specific content on demand.

  

  • Name shows the name of the timeline.
  • Status shows whether the timeline is played, paused or stopped.
  • Time shows the time the timeline is currently at.
  • Play Expression expression that trigger play.
  • Pause Expression expression that trigger pause.
  • Stop Expression expression that trigger stop.

  

  TIMELINES CONTEXT MENU

  You can access the Timelines context menu by right-clicking in the Timelines window. You can also open this menu from by clicking on the three horizontal lines in the top left corner of the Timelines window.

  

  • Add Timeline adds a new timeline.
  • Add Folder adds a new folder.
  • Delete deletes the selected Timeline(s).
  • Properties activates and shows the Timeline Properties window.

  FAQ

  Q. What is the benefit from using multiple timelines? Why cannot I just add another layer?

  A. Multiple timelines give you the possibility to organize your show into smaller chunks with descriptive names. It also allows you better control over when specific content should be played.

  CUE

  A cue is an object that exists on a layer in a Timeline. To create a cue you simply drag an asset from the Asset Manager to a layer on the Timeline. This will create a placeholder for the asset, the cue, that can be used to edit how the content of the asset is being used in a WATCHOUT show.

  

  WATCHOUT supports the following cue types:

  • Image
  • Video
  • Audio
  • 3D Model
  • Virtual Display
  • Capture
  • Composition
  • Variable
  • Control
  • String Output
  • Art-Net Output
  • Art-Net GDTF Output
  • Art-Net Recording Output
  • Marker

  When a cue is selected on the Timeline or in Stage, the Cue Properties window becomes active.

  If the Time Position Indicator overlaps the cue, and the cue refers to something visual, it will be shown in the Stage window.

  

  CUE TYPES

  In this section we cover the cue types you can use to build WATCHOUT shows.

  MEDIA CUES

  A cue that produces pixels or audio is referred to as a media cue. The word media cues are used in the documentation to explain concepts that are common for these cues.

  The following cues are considered to be media cues:

  • Image
  • Video
  • Audio
  • 3D Model
  • Virtual Display
  • Capture

  IMAGE CUE

  A cue that refers to an image asset like a .png or .psd file.

  VIDEO CUE

  A cue that refers to a video asset like a .mp4 or .mov file.

  AUDIO CUE

  A cue that refers to an audio asset like a .wav file.

  3D MODEL CUE

  A cue that refers to a 3D model asset like a .obj file.

  You can read more about 3D models here.

  VIRTUAL DISPLAY CUE

  A cue that is used to display content recorded by a virtual display. To create a virtual display cue:

  1. Right-click the Stage window and select Add Virtual Display.
  2. Drag the virtual display from the Devices window to a Timeline.
     • Note that you can replay the recorded content on the surface of a 3D model. To do so you need to drop the virtual display on top of a cue referring to a 3D model/mesh.

  Virtual display rendering does not come for free. To record content so that it can be replayed, the content must be rendered to an offscreen buffer on the GPU. This implies both more memory consumption and more rendering. Needless to say, you should use virtual displays with care to avoid severe performance penalties.

  This cue supports the same properties as an image cue.

  You can learn more about virtual displays here.

  CAPTURE CUE

  A cue that can be used to display data captured by a Capture Device. This cue supports the same properties as an image cue.

  COMPOSITION CUE

  A cue that consists of a group of cues defined on a Composition Timeline.

  A composition cue makes it easy to re-use or re-arrange show sections or short snippets. It also makes it easier to apply the same effect to a group of media elements – for instance, to move and scale a set of images together.

  There are two ways to create composition cues:

  • Primary approach:

    • 1. Select cues you want to group into a composition.
    • 2. Select Group Cues into Composition in the Producer/Timeline menu.
      • Note that you may also disband a group into separate cues. This is done by selecting Ungroup Cues from the Producer/Timeline menu.
        

    OR

  • 3D model approach:

    • Drop a 3D model asset containing multiple meshes to a Timeline or the Stage window.
    • Each mesh is represented as a cue on a separate layer which gives the possibility to play different media (and effects) on each mesh.

  To access the composition Timeline you can double-click on the composition cue. Note that this will only show what is present in the composition timeline, everything else is hidden.

  Changes made to a composition, such as swapping a media cue, will automatically be applied across all instances of that composition on all timelines.

  VARIABLE CUE

  A cue that refers to a variable defined in the Variables window. Create this cue by dragging a variable from the Variables window to the timeline.

  Select the cue and edit the Effect to configure how variable values change over time.

  CONTROL CUE

  A cue that can be used to trigger jumps in time and change playback state for one or multiple Timelines.

  STRING OUTPUT CUE

  A cue that gives you the possibility to send arbitrary data to a device on the network. The data is sent when the Timeline time reaches the cue Start Time.

  You can read more about its properties here.

  ART-NET OUTPUT CUE

  A cue that gives you the possibility to send a single or ten-channel output via the Art-Net protocol. Data sent is controlled by the different Effect levels.

  ART-NET GDTF OUTPUT CUE

  A cue that gives you the possibility to send single or multiple channel output via the Art-Net protocol defined by the GDTF file used. Data sent is controlled by the different Effect levels.

  ART-NET RECORDING OUTPUT CUE

  A cue that gives you the possibility to send a recoded sequence of Art-Net channels that have been recorded with the WATCHOUT Art-Net Recorder. Data sent can be modified by using the different Effect levels.

  MARKER CUE

  A cue that can be used to simplify WATCHOUT show monitoring and control. It gives the user the possibility to define a description and count down/up labels.

  CUE PROPERTIES

  In this chapter you will learn about the available Cue Properties.

  GENERAL

  The General section allows you to edit common data such as Start Time and Duration.

  

  • Start Time defines when the cue starts playing.
  • Color defines the color used for the cue on the Timeline.
    • The main purpose is to make it easier to organize the cues used in your show.
  • Lock can be activated to disable the possibility to edit a cue.
  • Media cue-specific settings:
    • Duration defines how long the cue will play.
    • Pre-roll defines how far ahead of the cue's Start Time the referred media asset will be prepared by the media server (loaded from the disk etc).
  • Control and marker cue-specific settings:
    • Name is a user-defined name for the cue. This can be useful when defining jumps in time.

  PLACEMENT

  The Placement section allows you to edit data related to the location of the cue in the Stage window.

  

  • Initial Position defines the position of the cue without any effects applied to it.
  • Initial Rotation defines the rotation of the cue without any effects applied to it.
  • Anchor Point defines a cue local point that does not move when scaling and rotating the cue.
    • The anchor widget, with arrows, can be used to move the anchor point to the corners, edges or the center of the cue.

  MEDIA PLAYBACK

  The Media Playback section allows you to edit data related to looping and time offset for the referred asset.

  

  • Free Running activates the play state of the cue regardless of the Timeline play state.
  • Looping activates looping of the referred asset.
    • Start Point defines when looping will start in the referred asset.
    • End Point defines when looping will end in the referred asset
  • In-time defines the offset before the cue starts playing the asset in question.
    • For instance, if you want to skip playing the first second of a video you can set this to one second.

  Free running and looping changes the appearance of the cue:

  • Free Running
  • Looping

  FADE IN/OUT

  The Fade-in/out section allows you to edit how the referred asset gradually becomes visible (fade-in), from when the play state reaches the cue, and how it gradually becomes invisible (fade-out) until the play state reaches the end of the cue.

  

  • Enable Fade-in adds a fade-in effect
  • Enable Fade-out adds a fade-out effect
  • Curve defines what curve to use for the effect.
  • Duration defines the duration of the effect.

  PRESENTATION

  The Presentation section allows you to edit data related to rendering of the asset.

  

  • Frame Blending activates smooth transitions between media frames.
    • Note that it consumes more memory.
  • HW Acceleration is used for decoding specific codecs, like HEVC.
    • Depending on your system and scenario it may be more efficient to keep this deactivated.
  • Blend Mode defines how cues using transparency are blended against what has already been rendered.
    • Available options are Add, Multiply, Screen, Lighten, Darken and Linear Burn.
  • Render Surface defines which parts of cue surface to render: Inside, Outside or Both Sides.
    • This can be useful when handling 3D models that have inconsistencies related to the front and back side of its polygons.
  • Stacking defines the order in which cues on the Timeline are rendered.
    • By Layer means that the layer number defines the render order.
      • Layer N is rendered before layer N + 1.
    • By Z means that the cue surface depth, the distance to the camera, defines the render order.
  • Show on Stage Tiers defines the tiers in which the cue will be rendered.
    • A display may decide to only render cues belonging to a specific tier.

  ASSET

  The Asset section allows you to edit data related to the asset.

  

  • Asset Version defines the version to use for the referred asset.
    • Latest means the cue will use the latest available version of the asset.
      • If a new version of the asset is created the cue will use the new asset version.
    • Fixed means that a fixed version for the referred asset is used.
  • SDR White Point defines the standard-dynamic-range white point in nits.

  CHROMA KEY

  The Chroma Key section allows you to enable chroma keying for a specific cue. Chroma is the degree of strength in a color.

  

  • Enabled toggles chroma keying on or off.
  • Show Alpha Mask can be enabled to show which pixels that will be kept and pixels that will be dropped (filtered out).
    • White pixels are kept (opaque).
    • Black pixels are dropped (fully transparent).
    • Red pixels are affected by the Spill Removal solution. You can read more about that below.
  • Target defines the chroma that will be filtered out (hidden).
    • Red channel.
    • Green channel.
    • Blue channel.
    • Hue of the target chroma.
    • Saturation of the target chroma.
    • Color opens a color widget allowing you to define the target chroma.
  • Tolerance defines how to handle chroma values that are close to the Target chroma in YUV-space.
    • Min defines how far from the target chroma, in YUV-space, chroma values are considered to be fully transparent (completely hidden).
      • The value defines the black circle, in YUV-space, shown in the image below.
        • Chromas that are inside this circle will be fully transparent (hidden).
      • This value should be below the Max value.
    • Max defines how far from the target chroma, in YUV-space, chroma values are considered to be fully opaque (not hidden at all).
      • The value defines the white circle, in YUV-space, shown in the image below.
        • Chromas that are between the black and white circle gradually change between fully transparent (at the border of the black circle) to opaque (at the border of the white circle).
      • This value should be above the Min value.
    • Spill Removal is used to reduce chroma keying artifacts around the border between kept and dropped pixels.
      • The value defines the red circle, in YUV-space, shown in the image below.
        • Chroma values that are between the white and red circle, values inside the "spill ring", will be desaturated to reduce artifacts in this chroma range.
          • The thickness of the "spill ring" is given by min (Max - Min, 0.1) * Spill Removal.
          • At the border of the white circle the saturation is given by 1.0 - Spill Removal.
          • At the border of the red circle the saturation is 1.0.
          • The saturation between the white and the red circle is interpolated between the values outlined above.
      • Even though the intention is to only affect pixels around the border it is important to understand that the solution is not border-aware and will thus affect all pixels that are within a specific chroma range.

  

  Example U-V color plane with Y = 0.5. Representation within sRGB color gamut (modified)

  License

  You can read more about this effect here.

  KEY & FILL

  The Key & Fill section allows you to make use of keying layers which you can read more about here.

  

  • Enabled toggles the key and fill feature on or off for this specific cue.
    • If turned on it means that the pixels of this cue will be used to fill whatever pixels that all keying layers have filtered/marked.
  • Invert can be activated to fill the inverted area filtered/marked by all keying layers.
  • Visualize Key toggles visualization of the key on and off.
    • Can be useful to understand what the key looks like for complex scenarios.

  You can read more about this effect here.

  MARKER

  The Marker section allows you to edit data related to marker cues.

  

  • Description contains an optional user-defined text.
  • Count Down activates a count-down label on the Timeline cue object.
  • Count Up activates a count-up label on the Timeline cue object.
  • Duration is used to control the time period in which the count down/up label is visible.

  OUTPUT

  The Output section allows you to edit data related to string output cues. A string output lets you send arbitrary data to a device on the network. The data is sent when the Timeline time reaches the cue Start Time.

  

  • Protocol defines the protocol to use for the data being sent.
    • TCP protocol.
    • UDP protocol.
  • Address defines the address of the device that should receive the data.
  • Data to Send defines the data, in text, that should be sent.

  PLAYBACK CONTROL

  The Playback Control section allows you to edit data related to control cues. A control cue can be used to edit the time and state of one or multiple Timelines.

  

  • Target Timelines defines which Timeline(s) that are affected by the Timeline Actions.
    • All makes the Timeline Actions affect all Timelines.
    • Others makes the Timeline Actions affect all but the Timeline in which the control cues exist.
    • List makes the Timeline Actions affect all Timelines checked in the Include drop-down.
  • Timeline Actions:
    • Jump defines if the player should make a jump when the show reaches the cue.
      • No Jump
      • To Time
      • To Cue
        • Target Cue defines a cue Name to jump to.
        • First searches for the closest cue residing after the control cue. If no match is found it then searches for cues residing before the control cue.
        • Backwards to Cue defines a cue Name to jump backwards to.
        • Only searches for cues residing before the control cue.
    • Set Timeline State defines the state of the timeline when the show reaches the cue.
      • Play
      • Pause
      • Stop

  CHANNEL MAPPING

  The Channel section allows you to edit data related to audio cues.

  

  • Input Channels defines the channels read from the audio source.
  • Buses defines where the Input Channels are routed.
  • Plus can be clicked to extend the channel matrix.

  There is more in-depth information on how to configure the Channel Mapping matrix in the following chapter.

  SIZE

  The Size section allows you to edit data related to the size of a 3D model.

  Imported 3D models are automatically scaled to fit a 1000 x 1000 x 1000 pixel cube.

  

  • Scale defines what method to use for setting the size.
    • To Size allows you to control the maximum extent (width, height or depth) of a 3D model.
    • By Factor allows you to set a uniform scale factor of the model.
      • If you set this value to 1.0 you will get the original size of the 3D model.

  If you want to perform non-uniform scaling you need to edit your 3D model outside Producer.

  There is more information about 3D models here.

  SURFACE

  The Surface section allows you to edit data related to the surface of a 3D model.

  

  • Name shows the name of the mesh.
  • Asset shows the name of the asset file that is referenced.
  • Remove Texture allows you to remove media that has been applied to the mesh surface.

  There is more information about 3D models here.

  FAQ

  Q. How does Looping work with In-time?

  A. If you have set In-time to non-zero only the first iteration of the looping will have the initial frames trimmed (according to the In-time). Later iterations will use the full length of the asset.

  Q. I have locked a cue. Can this cue be updated in any way?

  A. Yes. If the cue is using Latest for the Asset Version it will still be updated if an asset is updated with a new version.

  EFFECTS

  In WATCHOUT, Effects (called tweens in previous WATCHOUT versions) are applied to media Cues. An Effect is a real-time change to a media Cue when it is played back.

  EFFECT MENU

  Effects can be toggled on a media Cue by selecting it in the Timeline and using the Effect menu, or right clicking the Cue, and accessing the Effect menu that way.

  EFFECT VIEW

  Effects are shown in a single unified view, with a list of the different Effects assigned to the currently selected Cue, to the left (1). This list contains the name of the Effect, it's current value, together with a button (2) to toggle visibility of the Effect in the curve view.

  In the Effect curve view (3) you can edit the Effect curves by adding, moving, and in other ways, editing Tween Points.

  Read more about Tween Points here

  EFFECT PROPERTIES

  In the Properties window for Effects you can generally edit the Expression for this Effect. This can be used to tween the Effect value through inputs, via Variables.

  Read more about Variables and Expressions here.

  TWEEN POINTS

  As previously mentioned, Tween Points can be found in the Effect curve view. You can edit them by

  • clicking on a curve to add a point.
  • clicking a point to select it, and move it by dragging.
  • clicking anywhere else and drag to form a selection rectangle.

  

  TWEEN POINT PROPERTIES

  In the Properties window for Tween Points you can edit the time from start of the Cue, the value of the point, and what Transition to use when transitioning to this point, from the one before.

  

  TRANSITIONS

  As seen in the last image, there are a few Transitions to choose from. Linear is the default one, then there are some with different kind of smoothness, from Sinusoidal to Circular. Back, Elastic and Bounce add a special twirl to the Effect curve.

  

  POSITION EFFECT

  The Position Effect is quite different compared to other effects. Like other effects you can see the tween points in the Effect curve view. But the value of the tween points can not be changed by dragging the tween point up/down in this view. That is because the value of this Effect is the position of the Cue on Stage, which consists of three values: X, Y and Z. Thus, the Position Tween Points can also be viewed, selected and dragged in the Stage window.

  Start creating an animated Position Effect like this:

  1. Select a media Cue.
  2. Activate the Position Effect in the Effects menu, or by right clicking the Cue and locate the Position Effect that way.
  3. Move the Timeline marker forward a bit, eg towerds the end of the Cue.
  4. Click and drag the Cue in the Stage window, to a new position

  It should look something like this:

  

  Move the Timeline marker between the two points, and you can see that the position of the Cue on Stage is animated between these two positions. You can keep adding more points by placing the Timeline marker and moving the Cue on Stage. You can also, as with other Effect curves, click on the curve in the curve view, to add more points.

  

  Read more about Position Tween Points here.

  VISUALIZES MOVEMENT SPEED

  The Position Effect curve does not represent the value of the Position Effect, but the progress along the Position Effect curve. This is why the first point is allways at the bottom of the curve view, as this is the beginning of the curve, and the last point is at the top, corresponding of the end of the curve. To demonstrate how this can be helpful, here is an example:

  

  As you can see, the two last points are placed close to each other on the Stage, but on the Timeline, in the Effect curve view, you can see that they are spaced further apart. This means that the movement speed will differ when playing back this animation, it will slow down when moving past the second point. You can see this in the Effect curve, by looking at the incline of the curve: higher incline means higher speed (1), and lower incline means lower speed (2).

  

  By moving the middle point to the left on the Timeline, until the incline of the segment before and after the point are equal, you get movement with the same speed across the animation.

  

  POSITION EFFECT PROPERTIES

  Here you can, besides setting the expressions to control the three values of this Effect (X, Y and Z), set the ORIENT CUE ALONG PATH property of the Effect. Setting this property will make the Cue rotate, to orient itself along the direction of the movement curve. It may look something like this:

  

  POSITION TWEEN POINTS

  Position Tween Points are visible as green diamonds in the Stage window, when the cue they belong to is selected. Here they can be selected, dragged around, and deleted. In the Effect curve view, only their time value can be dragged, as mentioned before. If you switch the Stage to the First Person mode, you can move the points in all directions using the axis gizmo.

  

  POSITION TWEEN POINT PROPERTIES

  Besides the position value of the tween point, you can edit the following:

  SMOOTH HANDLES

  Set the Smooth In and/or Smooth Out properties to get handles to control the direction of the position curve. Use these to generate non-linear curves between the position points on Stage, to get a "smooth" movement animation. The control handles are visible as yellow diamonds in the Stage window. They can be linked or unlinked, using the Linked Handles property. See this example: (1): Linked handles; (2): Unlinked handles.

  

  Use linked smooth handles together with the speed visualization, to get a guaranteed smooth movement animation.

  

  TRANSITION

  Use Transitions to control the speed of movement across the position curve. For example they can be used to stop the animation smoothly on a point, and then smoothly accelerate up to speed again.

  

  Read more about Transitions here

  CHROMA KEY

  Chroma keying is an effect you can apply to a visual cue to filter out all pixels of a specific chroma. A common case for this is to hide the background of a video, by recording the video in front of a green/blue screen and then applying a chroma key effect to hide the background. Once the background is hidden you are free to replace it with something completely different.

  If you are familiar with alpha masking you can think of chroma keying as a way to define a dynamic alpha mask.

  You can read more about how you can activate and adjust this effect in the Cue Properties.

  Below is a simple example where we filter out a hand against green background:

  

  This is what the end result looks like:

  

  This is what it looks like if Show Alpha Mask is enabled in the cue properties (notice the red pixels around the outline of the hand):

  

  For more information about Chroma key, refer to Wikipedia

  KEY & FILL

  The Key & Fill effect can be useful for scenarios where you want to either highlight or hide specific pixel areas of one or multiple cues. It can also be useful in scenarios where you want to do creative fading effects.

  As the name suggests it consists of two pieces:

  • Key where you specify one or multiple pixel areas.
  • Fill where you specify what content you want to use to fill the Key pixel areas.

  The Key is created by first changing one or multiple layers into Keying Layers. The pixels for all cues placed on a Keying Layer are combined into a single Key. Then all keys, regardless of which Timeline the key belongs to, are further combined into a unified Key. The pixel areas defined by this Key can then be referred to by cues that want to Fill the Key with content.

  You can read more details about Keying Layers and how to define them here, and you can read more about how to define Fill here.

  The example below shows how to define a simple Key & Fill effect:

  1. Add a cue that you want to use for Key.
  2. Click on the cue's layer and in Layer Properties select to use Alpha Key to define the Key pixel areas.
  3. In Layer Properties turn it into a Keying Layer with the Enabled checkbox.
  4. Add a cue you want to use for Fill.
  5. Select the cue and in the Key & Fill section of the Cue Properties toggle the Enabled checkbox on.
     • Note: The paint bucket symbol in the cue indicates the Key & Fill effect.

  

  DEVICES & NODES

  Devices and nodes play a central role when setting up a WATCHOUT show and in this chapter you will learn about what devices and nodes are and how they can be configured.

  DEVICES

  At a very general level you can think of a device as something that transforms data. The device receives an input data stream and transforms that into an output data stream.

  WATCHOUT supports the following device types:

  • Display
    • This device type is used to configure how cues are recorded and how the recorded cues are presented in a show.
  • Capture
    • This device type is used to configure how video (and audio) streams can be captured and rendered by using a capture cue.
  • Audio
    • This device type is used to configure the playback of audio in a show.

  A node represents a machine, like a WATCHPAX, on your network and devices usually need to be associated with a node to become fully functional.

  DEVICES WINDOW

  The Devices window is divided into two vertical panes:

  • The left pane shows the available devices in the show.
  • The right pane shows the available nodes on the network.
    • A node represents a machine on your network.

  

  Each pane has its own context menu and you may access the context menu by right-clicking on the items in the two panes.

  DEVICES WINDOW RIGHT PANE

  This part of the Device window shows the available computers, also referred to as nodes, on the network. It consists of three columns:

  • Name shows the name of the node.
  • Services shows the services provided by the node.
    • Asset Manager uses a stacked disc icon
    • Director uses an earth icon.
    • Runner uses a running man icon.
  • Address shows the IP-address of the node.

  You may sort the items in the device list by clicking on the column labels.

  Producer uses a discovery system which means that it continuously scan for new available nodes on the Network. It also detects if a node is no longer available on the network by displaying the node name using red color.

  By right-clicking on a node you will open a context menu where you can find actions that can be performed on the selected node.

  

  • Add Display creates a new display on the selected node.
  • Add 3D Projector creates a new projector on the selected node.
  • Add Audio Device creates an Audio Device which requires play sound.
  • Add Capture Device creates a Capture Device which is required for NDI streaming etc.
  • Use Director pushes the show currently loaded in Producer to the targeted Director, actively replacing any show previously handled by the targeted Director.
    • Note: If the show was using a different Director before this command this Director is closed.
  • Close Director closes the Director on the selected node.
    • This may be useful in situations where you previously have used a node as a Director and now want to use the same node as Runner only.
    • Note: Having a Director and Runner on the same node running different shows should be avoided.
      • Look out for yellow warning triangles located next to the service icons in the Devices window.
  • Clear Show from Director clears the show currently handled by the targeted Director.
  • Use Asset Manager uses the selected node as the Asset Manager for the show.
  • Close Asset Manager closes the Asset Manager for the selected node.
  • Performance opens a page showing information about the targeted node. For instance you can get information about the available CPU, GPU and HDD.

  SERVICE STATE

  Your node name, the machine running Producer, is displayed using pink color. Pink color is also used to indicate if a Director or Runner is occupied. The Asset Manager is not colored pink because sharing an Asset Manager is considered to be safe and in a lot of situations preferred. That being said, if you rearrange assets in the Asset Manager you probably want to coordinate this with your team.

  

  NODE CONNECTION LOST

  If you lose connection to a node it will be colored red as shown in the image below. This can for instance happen if a computer has been idle for a period of time and the computer goes into sleep mode.

  

  If the node has not been seen on the network for five minutes it will be removed from the list of available nodes.

  NODE VERSION WARNING

  If the version being in use on Producer is not matching the version used on a specific node this will be indicated by using a yellow warning triangle. Using different versions on nodes can work but it is recommended to use the same version on all nodes utilized for show creation and playback.

  

  NODE FILTERING

  If there are many nodes on the network you are connected to it may be useful to filter out specific nodes. WATCHOUT provides three filters:

  • All which shows all nodes on the network.
  • Active in Show shows all nodes on the network that have at least one active service being used in the current show.
  • Referred by Show shows all nodes on the network that have at least one active service or device being used in the current show.

  

  DEVICES WINDOW LEFT PANE

  This part of the Devices window shows a list of the devices that have been added to the show.

  • Name shows the name of the node.
  • Host the name of the node it is associated with.

  You may sort the items in the device list by clicking on the column labels.

  If a device is selected the Device Properties will be populated with information and editing possibilities for that device. You may select multiple devices by holding using control (or shift) when clicking on devices in the device list. This can be very useful if you want to edit the same property for multiple devices in a single operation.

  By right-clicking on a device you will open a context menu where you can find actions that can be performed on the selected device(s).

  

  • Enable activates the device.
    • Enabling a device can also be done by pressing the heart icon, as shown here Display Properties.
    • For instance, enabling a display device will make it render the cues that are inside the display.
  • Edit Display Warp allows you to edit the warping for the display.
  • Edit Display Mask allows you to edit the masking for the display.
  • Cut cuts the selected device(s) allowing you to paste the device(s) later on.
  • Copy copies the selected device(s) allowing you to paste the device(s) later on.
  • Delete deletes the selected device(s).
  • Add Capture Device creates a Capture Device which is required for NDI streaming etc.
  • Add Virtual Display creates a new virtual display.

  DEVICE FILTERING

  If you have many devices in your show it may be useful to filter out specific device types, as shown below:

  

  NODE PROPERTIES

  In this chapter you will learn about the available node properties. These properties will populate the Properties window once a node has been selected.

  INFO

  In this section you can find information about a node that has been selected in the Devices window. This section is only shown if a single node is selected, otherwise it is hidden.

  

  • Name of the node.
  • Service the node provides.
    • If the Director or Runner is occupied the icon is colored pink.
  • Sync shows how NTP is synced on the node.
  • Last Seen shows when the node was last seen on the network.
  • Version shows the version of WATCHOUT the node is using.
    • If a warning icon is shown it means that the node does not run the same version of WATCHOUT as Producer.
  • Machine ID shows a uuid that WATCHOUT uses to identify the node on the network.
  • Show Director shows a uuid for the show that is currently loaded on the Director existing on the node.
    • This is set to NONE if there is no show loaded on the Director.
  • Show Runner shows a uuid for the show that is currently loaded on the Runner existing on the node.
    • This is set to NONE if there is no show loaded on the Runner.

  ACTIONS

  In this section you find the available actions that can be executed on the selected node(s).

  Many actions that can be performed here must be used with great care since they may be destructive to your setup.

  

  • Splash Screen allows you to enable or disable he splash screen for the node.
    • Note: You may only enable the splash screen if no display output is enabled for the node.
      • If you want to see more information about the node while having it display show contents you can activate Render Info.
  • Restart Services restart the services on the selected node(s).
  • Startup Action allows you to define what should happen when the WATCHOUT Manager process is started. There are three settings:
    • No Show which will not attempt to load any show. This is the default setting.
    • Last Show which will start a Director on the node and load the last show that was sent to the Director.
    • Specific Show which will start a Director on the node and load a specific show.
      • Use the Upload Show button in the Startup Action dialog to upload a specific show to the node.
  • Local Asset Cache opens a dialog that shows all assets that are locally cached, i.e. have been downloaded from a remote Asset Manager.
    • Refresh button can be used to refresh the list of assets.
      • This may be useful if you are currently downloading assets.
    • Recycle button can be used to clear the cache of assets that are not used in the current show.
      • This may be useful to free space on nodes, but it also means that the node must download assets again.
  • Shutdown allows you to shutdown the machine associated with the node.
  • Restart allows you to restart the machine associated with the node.
  • Rename Machine allows you to rename the node representing your machine.
    • This action can only be performed on a single node at a time.
  • Change Working Directory allows you to change the working directory for WATCHOUT.
    • The working directory is where essential WATCHOUT data, such as assets, is stored.
    • This action can only be performed on a single node at a time.
  • Sync Settings allows you to override the WATCHOUT clock synchronization between all the nodes used in your show.
    • By default WATCHOUT configures this for you but you may decide to do this in a custom way by disabling the WATCHOUT time sync.
    • Use at your own risk since it may result in nodes playing frames out of sync.
  • Update Software allows you to update the WATCHOUT software version on the selected nodes to use the same version that is currently running your Producer.
  • Switch to WATCHOUT 6 allows you to switch the selected nodes to using WATCHOUT 6 and restart the machine(s).
    • This will only affect nodes associated with WATCHPAX servers.

  CAPTURE

  A capture device allows you to capture data streams produced by various sources. WATCHOUT supports capturing NDI® streams, video streams from live cameras etc.

  The captured stream can be added to a WATCHOUT show as a cue. Then you may add effects can further tweak how the captured stream is rendered.

  To set up a capture stream you need to:

  1. Create a capture device.
  2. Add a stream to the device.
  3. Drag the device to a Timeline which will create a cue referring the captured stream.

  

  CAPTURE PROPERTIES

  In this chapter you will learn about the available Capture Properties.

  GENERAL

  This section contains the possibility to set a name for the capture device and define the resolution for all cues that will be referring to the captured stream.

  

  • Name a user defined name for the capture device.
  • Width defines the width, in pixels, of the cue associated with the stream being captured
  • Height defines the height, in pixels, of the cue associated with the stream being captured.

  SOURCES

  This section gives you the possibility to configure which streams the capture device should listen to.

  

  • Sources shows a list of the streams that this capture device will listen to. WATCHOUT will use the first valid stream starting at the top of the list.
    • Trash can button lets you remove a specific stream.
    • Arrow Up/Down buttons allows you to rearrange the priority of the streams.
    • Remove All removes all streams that have been added to the capture device.
      • The order in which streams appear in the list will decide the order in which they will be displayed. Streams are prioritized from top (highest priority) to bottom (lowest priority). If the topmost stream in the list is unavailable WATCHOUT attempts to stream the one below it, etc.
  • Add NDI® Source
    • Stream lists all available NDI® streams.
  • Add Capture Source
    • Host defines the name of the host/node/machine to create a capture stream from.
    • Stream lists all available, non NDI®, streams that can be captured on the selected Host.
    • Format defines the format to use for the stream.
    • Range defines the range to use for the stream.
      • Auto range means WATCHOUT uses whatever range the device decides.
      • Limited range means WATCHOUT overrides the range set by the device to a limited range, i.e. low quality.
      • Full range means WATCHOUT overrides the range set by the device to full range, i.e. high quality.

  VARIABLES & EXPRESSIONS

  Variables can be used to control and influence the behavior of WATCHOUT. They can get their value from external input, tweens or other variables.

  Why use variables

  • Variables can start, pause or stop a timeline
  • Variables can be used to set effects

  How do variables get their value

  • From external input
  • From user dragging the slider
  • From other variables, via a variable cue
  • From tweens on a variable cue

  

  Picture above shows the Variables window. To create a variable choose Add Variable from the menu located in the upper left corner of the Variables window.

  Double or single click on a variable to get to its properties.

  

  Variable properties includes

  • Name, name of variable
  • Key, input key that can be learned
  • Minimum Value/Maximum Value, minimum and maximum value the variable can have
  • Default Value, the default value the variable will have at startup
  • Interpolation, the way the system interpolate between the incoming values
    • None, no interpolation
    • Linear, linear interpolation that, if needed, adds values between two input values

  For more details

  OSC VARIABLE

  WATCHOUT can accept osc (open sound control) which is a protocol for controlling multimedia devices over a network. in the example below, Touch osc is to demonstrate the osc input. Touch OSC is a mobile app (avail- able on apple app store or Google Playstore) that lets you create customizable touch interfaces. These are used to control software and hardware applications through touch gestures. The app has a number of built-in layouts or you can use the Touch Editor software to design your own interface with buttons, sliders, rotary knobs and other touch elements. These can then be wirelessly connected to your WATCHOUT Producer computer.

  once you have designed your interface, transfer the layout to a smart phone. Now connect the Touch OSC app to the WATCHOUT Producer using the iP address of the Producer.

  EXAMPLE

  in the Producer software, open the Variables window from the Window menu. a volume variable is shown by default.

  

  click on the hamburger menu in the top left of the Variables window and select “add Variable”.

  

  double-click on the Variable to bring up the Variable Properties window. Give the variable a name, click on learn and then activate the relevant Touch osc control. WATCHOUT will show it in the drop- down list in the inputs window. Test that the input is working by triggering the Touch OSC control. The value should go from 0 to 1.

  

  assign the Variable to a timeline in that timeline’s properties window.

  

  The same process applies to an Effect. in the example below, the fader is used to control opacity on a media cue.

  

  

  FAQ

  Q. What port does WATCHOUT use for OSC?

  A. 8000.

  Q. Does WATCHOUT support OSC over TCP?

  A. No, only UDP works.

  Q. Where can I learn more of OSC?

  A. More information about Open Sound Control (OSC) can be found on Wikipedia.

  DMX VARIABLE

  Note: As WATCHOUT does not directly support DMX input, you'll need to utilize an Art-Net adapter to convert DMX to Ethernet. Once converted, you can add a Variable.

  You can listen to Art-Net channels by specifying the variable key as follows: artnet.universe(1).channel(2), which binds the variable to channel 2 of Art-Net universe 1.

  Specifying Universe

  When specifying the universe, provide a value between 0 and 32767. If not specified, universe 0 will be used by default.

  Higher Resolutions

  By default, a single Art-Net value is represented as an 8-bit value. However, Art-Net supports higher resolutions by bundling up to four channels together. To bind multiple channels to the same variable, specify them like so: artnet.uv(1).ch(1, 2), where 1 represents the coarse channel and 2 the fine channel. Alternatively, you can use this syntax: artnet.uv(1).coarse(1).fine(2).ultra(3).uber(4).

  All of the following examples are valid:

  • artnet.channel(1)
  • artnet.universe(42).channel(1)
  • artnet.universe(42).channels(1)
  • artnet.universe(42).channel(1).normalized()
  • artnet.universe(42).channel(1,2)
  • artnet.universe(42).channels(99,2,3,4)

  Interpretation

  In many situations, working with normalized values is more convenient than dealing with absolute values. We support this by appending .normalized() to the end of the variable key. The resulting value will be a floating-point number between 0 and 1.

  If you need to work with absolute values, note that the resulting maximum value depends on the number of channels you specify.

  Channels	Bits	Expression	Decimal
  Coarse	8	2^8 -1	255
  Coarse + Fine	16	2^16 - 1	65535
  Coarse + Fine + Ultra	24	2^24 - 1	16777215
  Coarse + Fine + Ultra + Uber	32	2^32 - 1	4294967295

  Note: You need to manually set this in the maximum field.

  For more information about Art-Net, refer to Wikipedia

  MIDI VARIABLE

  WATCHOUT 7 has a separate app for MIDI control, which can be installed on the Producer node.

  

  Open the MIDI Bridge app and then choose the MIDI device to use.

  

  FAQ

  Q. What computer shall I run MIDI Bridge on?

  A. The MIDI Bridge can run on any computer, as long as it can connect to the Director of the show.

  Q. Can i run more than one instance of MIDI Bridge on one computer?

  A. Yes, example if you want to use more then one MIDI device at the same time, you need to connect them to different MIDI Bridges.

  Q. Shall I use normalized values?

  A. In most cases yes. Normalized values gives you a value between 0 and 1. Otherwise you will get a value between 0 and 127.

  LTC INPUT

  LTC (Linear Time Code) is time code data encoded into an audio signal. LTC Bridge listens on a audio interface for this code, and the it controls time on at least one timeline.

  LTC Bridge looks like this

  

  Choose the input type and Host.

  Timelines will show the available Timelines in the WATCHOUT show that can be controlled.

  FAQ

  Q. Can I control more tha one timeline?

  A. Yes.

  Q. Can I run many LTC Bridge applications at the same computer?

  A. Yes, as long as you use different audio interfaces?

  Q. What computer shall I run LTC Bridge on?

  A. The LTC Bridge can run on any computer, as long as it can connect to the Director of the show.

  More information about Linear Time Code (LTC) can be found on Wikipedia

  VARIABLE AS A CUE

  A variable can be used as a cue if you drag it from the Variable window to a timeline

  

  A Variable cue is a way to change the variable value, and always have a effect. This effect changes the value either by a tween track, or by an expression containing other variable(s)

  FAQ

  Q. When is this useful?

  A. If you want a variable that changes depending on timeline time.

  Q. When jumping on the timeline the value if variable cue is not updated?

  A. the value is only updated if you play into the cue.

  VARIABLE PPROPERTY

  NAME

  The name of the variable.

  All names are the same even if they differ in case. This means that "largeCar" and "largecar" will be evaluated the same.

  You can tab complete variable names in expressions.

  INPUT KEY

  This field is needed if you like to control this variable by an extaernal input using MIDI, OSC or Art-Net

  You can type the key manually. For OSC and MIDI have the WATCHOUT learn it for you. To learn press the learn button

  key example:

  • OSC: /1/fader1/0 or /3/xy/y/0
  • MIDI: midi.ch(0).cc(7)
  • DMX: artnet.uv(1).ch(2)

  MINIMUM, MAXIMUM AND DEFAULT VALUE

  Minimum and maximum values set the possible range for this variable.

  Default value is the value stored in the show file, and is used before input is received or when the system is reset.

  As a guide, use these minimum and maximum values for all variables:

  • 0-1 – for switches
  • 0-100 – for faders
  • 0-255 – for DMX

  HOW SHOULD THE VALUE BE INTERPOLATED

  Input data does not always come each frame. This can cause a rotation to look very bad. Watchout can help you smooth this out if you enable interpolation.

  EXPRESSIONS

  Everywhere variables are used they are part of an expression. In fact, it is expressions that starts or stops timelines. It is expressions that tells how an effect behaves.

  EXAMPLE OF EXPRESSIONS

  • "masterVolume" the value of master volume
  • "tweenValue" The value of a curve at this point in time
  • "tweenValue -1" tweenValue -1
  • "1+23/4^5%6 + log(100K) + log(e(),100) + [3(3-3)/3] + (2<3) && 1.23" Random complex expression
  • "masterVolume > 0.4" logical expression

  FORMAL DEFINITION

  Numbers:

  • Integers: 1, 2, 10, 100, 1001
  • Decimals: 1.0, 1.23456, 0.000001 1 or 1.0 is true 0 or 0.0 is false

  Operators:

  • () Parenthesis
  • ^ Exponentiation
  • % Modulo
  • / Division
  • * Multiplication
  • - Subtraction
  • + Addition
  • == != < <= >= > Comparisons (all have equal precedence)
  • && and Logical AND with short-circuit
  • || or Logical OR with short-circuit

  Functions:

  • e() -- Euler's number (2.718281828459045)
  • pi() -- π (3.141592653589793)
  • int(val)
  • ceil(val)
  • floor(val)
  • round(modulus=1, val)
  • abs(val)
  • sign(val)
  • min(val, ...) -- Example: min(1, -2, 3, -4) == -4
  • max(val, ...) -- Example: max(1, -2, 3, -4) == 3
  • sin(radians) * asin(val)
  • cos(radians) * acos(val)
  • tan(radians) * atan(val)
  • sinh(val) * asinh(val)
  • cosh(val) * acosh(val)
  • tanh(val) * atanh(val)

  OUTPUTS

  There are multiple ways to output information from WATCHOUT to external systems.
  The current version of WATCHOUT supports:
  

  • String output via TCP or UDP.
  • Art-Net single or multiple channel output using built-in presets.
  • Art-Net single or multiple channel output using a GDTF asset file.
  • Art-Net output using a pre-recorded Art-Net asset created by the WATCHOUT Art-Net Recorder.

  This chapter describes the different alternatives in more detail.

  STRING OUTPUT

  A string output is created by right-clicking on the timeline and selecting Add Output Cue.
  

  An output cue is represented by a box-arrow-right icon on the timeline. It can be used to send a string message over TCP or UDP.

  

  
  

  It has the following properties.

  

  1. Name Name of the Cue.
  2. Start Time Cue location the timeline.
  3. Protocol Output protocol to use, TCP or UDP.
  4. Port Port number to use.
  5. Data To Send The string of data to send. It supports all the usual backslash and escape sequences and all Unicode characters.

  Note: 0xff are ignored.

  An output string like “\xaaHej\n\tvärlden!\x10\xff” will turn out as:

  aa 48 65 6a 0a 09 76 e4 72 6c 64 65 6e 21 10 ff

  ART-NET OUTPUT

  An Art-Net output can be created by using the built-in Art-Net fixture presets that give you the possibility to chose from a single (1) channel preset or a 10-channel preset.

  USING ART-NET PRESETS

  The 1-channel or 10-channel Art-Net fixture preset is added to the Asset window by right-clicking in the Assets window and selecting Add Art-Net fixture and then selecting 1ch Generic or 10ch Generic. You can add as many Art-Net fixture assets you want and give them unique names, or you can use a single one and create multiple cues from that one.

  

  
  

  Art-Net fixture assets in the Asset window are shown below.

  

  
  

  You create a cue by dragging the Art-Net asset into a timeline layer. Depending on the Art-Net asset type used you will have one or ten tween layers that can be used to manipulate the different Art-Net channel values.

  

  
  

  

  
  

  Selecting the cue will show the Cue Properties window.

  

  1. Name Name of the Cue.
  2. Start Time Cue location on the timeline.
  3. Duration Cue duration on the timeline.
  4. Pre-roll Cue pre-roll time.
  5. Net Universe start address in steps of 256 universes.
  6. Sub-Net Universe start address in steps of 16 universes.
  7. Universe Universe start address in steps of a single universe.
  8. Universe (absolute) Universe start address in absolute terms.

  Note: You can use the Net / Sub-Net / Universe to enter the Universe you want to use, and the absolute value will automatically be calculated, or you can enter the absolute address directly.

  9. Channel Output channel start address.

  Note: If you use the 10-channel Art-Net preset, output channel 1 will use the channel number set in the Channel field. Output channel 2 through 10 will use the following 9 channels.

  

  10. Mode Defines the resolution of each of the Art-Net channels. The resolution can consist of 1, 2, 3 or 4 consecutive bytes grouped together to increase the resolution of the channel.

  Note: Using a 10-channel Art-Net preset and a Mode set to Uber (32bit) means that each channel will reserve 4 consecutive bytes. So, output channel 1 will use the channel number set in the Channel field as a base, output channel 2 will use the number in Channel +4 as a base, output channel 3 will use the number in Channel +8 as base, etc.

  11. Asset Version Defines what version of the asset to use.
  
  

  For more information about Art-Net, refer to Wikipedia

  ART-NET GDTF OUTPUT

  A standard GDTF (General Device Type Format) fixture descriptions file can be imported directly into the WATCHOUT Asset Manager. WATCHOUT will recognize the different GDTF channel setups in the GDTF file and let the user directly manipulate each channel's parameter individually.

  For more information on the GDTF standard, and to read more about how it works, visit the GDTF homepage. There you can also search libraries for a specific fixture or create and configure your own fixture file.

  USING GDTF FILE

  Import the GDTF file into the Asset Manager by dragging and dropping the file into the Assets window or click in the top left menu in the Assets window and select New Media File....

  This example uses a downloaded GDTF file for a Martin Professional MAC250 fixture.

  

  
  

  Drag the GDTF asset into a timeline layer to create a cue. Depending on the GDTF file used you will have one or more tween layers that can be used to manipulate the different Art-Net channels.
  The GDTF standard allows for different values to represent different functions, which means the name shown for the different channels may change depending on the parameter value. This makes it easier to program a correct level for a function since the user can clearly see the result of a specific value, for example, if a value for a shutter is open or closed.

  

  
  

  Selecting the GDTF cue will show the cue properties.

  

  1. Name Name of the Cue.
  2. Start Time Cue location on the timeline.
  3. Duration Cue duration on the timeline.
  4. Pre-roll Cue pre-roll time.
  5. Net Universe start address in steps of 256 universes.
  6. Sub-Net Universe start address in steps of 16 universes.
  7. Universe Universe start address in steps of a single universes.
  8. Universe (absolute) Universe start address in absolute terms.

  Note: You can use the Net / Sub-Net / Universe to enter the Universe you want to use, and the absolute value will automatically be calculated, or you can enter the absolute address directly.

  9. Channel The base channel address for the fixture.

  Note: If you are using multiple fixtures in the same universe make sure that the base address is set so you do not overlap two or more fixtures. Example: if a fixture requires 12 channels and has a base address of 1, make sure that the next fixture's base address is set to 13 or higher.

  10. Mode The GDTF standard allows for a fixture to have different modes. For example, a moving head has modes that require 10, 12 or 14 Art-Net channels. This is defined in the GDTF files as different modes, and the WATCHOUT user can select which of the modes to use by changing the Mode parameter.
  
  
  11. Asset Version Defines what version of the asset to use.
  
  

  For more information about Art-Net, refer to Wikipedia

  ART-NET RECORDING OUTPUT

  An Art-Net recording is created with an external app, stored in a file, and then added into the Asset Manager's database for use as a cue on a timeline, to output Art-Net values.

  WATCHOUT ART-NET RECORDER APP

  The Art-Net Recorder app is used to record, in real-time, data from a specific Art-Net universe. The app is installed in the same folder as WATCHOUT and a shortcut is created on the desktop. Start the app by double-clicking on the desktop icon.

  

  
  

  Once the WATCHOUT Art-Net Recorder is started you can start configuring the app.

  

  1. The settings for the Art-Net universe to be recorded are located at the top left and there are three different parameters to set:

  • Net Universe start address in steps of 256 universes, range 0-127.
  • Subnet Universe start address in steps of 16 universes, range 0-15.
  • Universe Universe start address in steps of a single universes, range 0-15.
    The resulting universe in an absolute value will be the sum of
    (Net x 256 + Subnet x 16 + Universe) in the range of 0-32767.

  2. The lower part shows the 512 individual channels that make up one Art-Net universe. You can select all channels or a number of individual channels to be recorded.

  3. Once you have selected the channels, start the recording by pressing the Record button.

  
  

  

  Note: If you get this error message when you start the app, you probably have the WATCHOUT Manager running in the background, blocking the Art-Net port. Stop the application blocking the port and re-start the WATCHOUT Art-Net Recorder to continue.

  
  

  

  4. When the recorder is running, you can see information about recorded time, number of Art-Net packages per second and the total number of Art-Net packages recorded displayed to the left.

  5. When the recorder is running, the selected recording channels will show a visual indication of the level received for each channel by changing the intensity of the color.

  6. To stop the recording push the Stop button.

  
  

  When the recording is stopped there are several options available next.

  

  7. Jump back to beginning of recording.
  8. Play the recording to preview the recording.
  9. Save the recording to a file (ndjson), for later import into WATCHOUT.
  10. Discard the current recording and prepare for a new recording.

  11. When the preview of the recorder is playing, the selected recording channels will indicate the level received for each channel by changing the intensity of the color.
  As an alternative, scroll down to the bottom of the app and the recorded channels will be previewed with waveforms for a more detailed view of the recording.

  

  
  

  USING ART-NET RECORDINGS IN WATCHOUT

  Import the Art-Net recording file (ndjson) into the Asset Manager by dragging and dropping the file into the Assets window or click in the top left menu in the Assets window and select New Media File....

  This is an example of how an Art-Net recording file looks like in the Assets window.

  

  
  

  Drag the Art-Net recording asset into a timeline layer to create a cue. Depending on the number of recorded channels in the recording, you will have one or more tween layers for the cue.

  You can override the maximum values of the recorded channel by manipulating the tweens of the different Art-Net channels. The value is set to 100% by default, but the value shown in the tween area on the left reflects the current maximum value that can change over time when the cue is played over.

  

  
  

  Selecting the Art-Net recording cue will show the Cue Properties.

  

  • Name Name of the Cue.
  • Start Time Cue location on the timeline.
  • Duration Cue duration on the timeline.
  • Free Running Activates the play state of the cue regardless of the Timeline play state.
  • Looping Activates looping of the Art-Net recording asset.
  • In-time Defines the offset where the Art-Net recording will start playing.
  • Net Universe start address in steps of 256 universes.
  • Sub-Net Universe start address in steps of 16 universes.
  • Universe Universe start address in steps of a single universes.
  • Universe (absolute) Universe start address in absolute terms.

  Note: You can use the Net / Sub-Net / Universe to enter the Universe you want to use, and the absolute value will automatically be calculated, or you can enter the absolute address directly.

  • Channel The base channel address for the Art-Net recording cue.
  • Mode Not used by the Art-Net recording cue.
  • Asset Version Defines what version of the asset to use.
  
  

  At the bottom of Cue Properties window for the Art-Net recording cue, there is a table that allows for changing the mapping between the recorded Art-Net channel and the Art-Net playback channel.

  

  
  

  For more information about Art-Net, refer to Wikipedia

  3D

  In this chapter you will learn about working with 3D models and setting up 3D mapping using WATCHOUT.

  

  MODELS

  In this section you can learn more about working with 3D models in WATCHOUT.

  

  3D MODEL IMPORT

  Producer supports import of the following file formats:

  • .obj
  • .gltf (or .glb)
  • .3ds

  If you are going to use the imported 3D model for 3D mapping it is required that the model has uv-coordinates.

  3D SPECIFIC CUE PROPERTIES

  There are two 3D specific properties for cues:

  • Size which lets you change the size of the model.
  • Surface which shows some information about the 3D asset and lets you remove media that has been applied to the 3D model.

  MULTIPLE MESHES

  When a 3D model is added to a Timeline a composition is created and each mesh of the 3D model is placed on a separate layer. This allows you to play different media and effects on the different meshes. The mesh names cannot be edited in Producer.

  EDIT 3D MODELS

  WATCHOUT has very limited 3D model editing possibilities. If you are unhappy with the mesh names or there are visual problems in the 3D model these need to be handled in a program specialized in that, like Blender etc.

  3D MAPPING

  3D mapping refers to projecting media to fit onto object surfaces, such as statues or cars. The process includes positioning projectors and objects in the real world, creating a virtual scene in WATCHOUT, then calibrating projectors, and projecting media. Calibration involves aligning virtual and real-world points.

  To setup 3D mapping you will need:

  • One or more objects to project media on.
  • One or more 3D models representing the objects you want to project your media on.
  • One or multiple projectors.

  The setup process can be divided into the following steps:

  1. Position your projector(s) and object(s) you want to project on in the real world.
  2. Prepare a virtual scene in Producer by adding and position 3D models and projectors matching the real world from the first step.
  3. Calibrate each projector by trying to align the virtual scene with the real scene.
  4. Play media on the surface of the object(s).

  In the following sections you can learn about how to prepare a virtual scene and how to align that scene with reality through a calibration step.

  VIRTUAL SCENE

  To prepare a virtual scene you can begin by dropping a file containing a 3D model representing the real object(s) you want to project on. It is very important that the 3D model(s) closely matches the real object(s) from a proportion perspective, otherwise it will be very hard or even impossible to perform the calibrationstep later. When the Asset Manager has finished preparing the 3D model it can be dragged from the Assets window to a layer on the timeline. It can also be dropped directly to the Stage window.

  It is recommended to switch to the [First Person](../stage/stage.md#first-person) camera mode when working with 3D models since this allows you to view and inspect the 3D model freely. A model that still does not have any media/texture applied to it will be rendered using wireframe.

  

  You can change the position of the 3D model by using the axis gizmo or by inputting values in the Cue Properties window.

  

  Note that the location of the 3D model in the virtual scene is not important for the 3D mapping to work, it is the relation between the virtual projector and the 3D model that is important. For instance, the 3D model can be placed far away on the x-axis, as long as the projector can “see” it from an angle matching the real-world relationship.

  Once the 3D model(s) has been placed in the scene the next step is to add a projector in Producer and position the projector so it can “see” the 3D model(s). To add a projector you can right-click in the Stage window and select Add 3D Projector.

  

  Next you can either change the Target and Eye for the projector in the Display Properties window or you can control the projector as if it was a camera. As an alternative you can position the projector by controlling it as a First Person camera.

  To do this you can either click the Frame in Stage button found in the Display Properties window or by double-clicking the projector. This camera mode is referred to as Projector mode.

  

  CALIBRATION

  Provided you have prepared your virtual scene you are now ready to calibrate the projector. The goal with the calibration is to align virtual points with points existing in the real-world. If done correctly it is possible to seamlessly project media on top of a real object. The calibration process consists of the following sub steps:

  • Place virtual points on the 3D model(s).
  • Move reality points so they are at the corresponding real location on the real object.
  • Align the camera to minimize the distance between the virtual and reality points.

  Here is an overview of the UI:

  1. Switch between View and Calibration mode.
     • The projector may only be moved in View mode, for instance by using the W-, A-, S-, D- or arrow-keys.
  2. Reset the calibration.
  3. Edit virtual points.
  4. Edit reality points.
  5. Add points.
  6. Move points.
  7. Remove points.
  8. Enable/Disable vertex snapping.
  9. Link/Unlink the projector to the camera.
  10. Manual edit of calibration points.
      • Update the calibration only when the calibrate button (14) is clicked.
  11. Continous calibration.
      • When a reality point is moved the calibration is updated immediately.
  12. Control the movement velocity for the reality points.
  13. Reposition the reality points on top of the virtual points.
  14. Perform calibration.
  15. Indicates how well the calibration solution could align the virtual and the reality points.
  16. Exit projector mode.

  VIRTUAL POINTS

  There are three types of edit operations you can perform when you place virtual points on the surface of a 3D model:

  • Add point.
  • Move point.
  • Remove point.

  To add a virtual point, you need to activate the add (+) edit operation and click somewhere on the surface of the 3D model. When a point has been placed it can be moved or removed by activating the other available edit operations. To simplify placing virtual points there is a snapping option that can be enabled or disabled. When the snapping is active, adding and moving virtual points will snap to nearby vertices, basically the points that define the surface of the 3D model.

  You may also unlink the projector from the camera to simplify placement of points without moving the projector. You can toggle the linked state by clicking the linked icon. When a projector is relinked to a camera the camera will move to the projector’s POV, not the other way around.

  Six virtual points are required to be able to calibrate a projector successfully. More points can be added to further constrain the mapping but please note that more points does not necessarily give a better result.

  

  REALITY POINTS

  The reality points are automatically created from the virtual points. These points are not directly bound to the surface of a 3D model but since each reality point is associated with a virtual point they are indirectly bound to the surface of the 3D model.

  There are two ways to edit the reality points:

  • Manually.
  • Continuously.

  It is recommended to start by moving the points manually to give an approximation of where the points should be located. To move a calibration point you need select it by left-clicking on it (or close to it). You may also select reality points by using W-, A-, S- and D-keys or by using the left stick on a compatible gamepad. Once selected, a point can be moved by using the arrow keys or by using the right stick of a gamepad. When moving a reality point the goal is to make a virtual point on the 3D model match the corresponding reality point on the real object. For instance, if you select a virtual point located on the lower left corner of a box you want to make the corresponding reality point project on the lower left corner of the box from the real world. Once all reality points have been moved you can click Calibrate to try to align the virtual and reality points with each other.

  There is a accuracy percentage label indicating of how well the system can perform this alignment of points. If the label says 100% you have perfect alignment but you can still achieve good results even with lower accuracy level.

  In the manual mode it is also possible to Reposition the reality points. If you click that button you will reset reality points placed exactly over the virtual points. This may be useful if you end up in situations where the calibration gives very poor results.

  During fine tuning of the calibration process, it might be helpful to activate the Continuous calibration mode. This mode will update the calibration directly when a reality point is moved. If this mode is being used when some of the reality points are far from their correct locations, you might experience severe jumps of the projector making the calibration process hard to complete. So again, only use this mode for fine tuning.

  When adjusting the reality points it might be useful to hide the UI overlaying the Stage window. To do so you need to locate the button represented by an eye at the top of the Stage window. Click it to toggle the UI on/off.

  

  AUDIO

  In this chapter you will learn about working with audio in WATCHOUT.

  AUDIO DEVICES

  An audio device is added to a node by right-clicking the node in the Devices window, and selecting Add Audio Device.

  
  

  By default the newly created audio device is disabled, and the actual device is unspecified. Leaving the device as unspecified means that the default audio device of the node is used. However, it is possible to select a different device type (WASAPI, WASAPI exclusive, Dante or ASIO), and select a different device. Depending on the device type and capabilities of the device it is also possible to set paramaters such as number of channels, sample rate and delay.

  
  

  CHANNEL MAPPING

  In the first step of channel mapping, the individual channels of an audio cue are routed to audio buses, this is done in the Cue Properties window. By default, there are two buses, named Left, and Right, and the left and right channels of an audio cue are routed to those buses.

  

  A single click in the channel mapping matrix switches the item from selected to unselected. Double clicking gives the user the opportunity to actually edit the value of the item. By default a selected item means the value is cueVolume, which always has the value of the volume tween for the cue.

  The second step of the channel mapping takes place in the Device Properties window. Here is where the mapping of buses to audio device channels are performed. Note that the default value for a checked box in this view is masterVolume, which is a varable that is always present. The user can of course add other variables to use instead of masterVolume, for instance adding a variable monitorVolume and using that in the channel mapping for the audio device carrying monitor audio (e.g. headphones of the operator). Please note that the expression in the channelmapping for audio device shall evaluate to a value between 0 and 100, as opposed to the expression of the cue channel mapping that shall evaluate to a value between 0 and 1.

  IMPLEMENTING BALANCE

  To implement a traditional balance control for a cue, it is possible to introduce a balance variable, and set the channelmapping for the cue according to the images below.

  

  Below is an example of channel mapping for balance control of a cue:

  

  EXTERNAL PROTOCOL

  OPERATIVE SERVER EXAMPLE USAGE

  CURRENT PLAYBACK STATUS

  curl.exe http://localhost:3019/v0/state

  GET THE CURRENT SHOW JSON

  curl.exe http://localhost:3019/v0/show

  LOAD ANOTHER SHOW

  curl.exe -X POST -H "Content-Type: application/json" http://localhost:3019/v0/show --data @FILENAME

  PLAY/PAUSE/STOP TIMELINE BY ID

  • curl.exe -X POST http://localhost:3019/v0/play/0
  • curl.exe -X POST http://localhost:3019/v0/pause/0
  • curl.exe -X POST http://localhost:3019/v0/stop/0

  JUMP TO TIME

  • format "/v0/jump-to-time/{tl_id}?time={time}&state={state}"
  • {tl_id} is timeline id
  • {state} is play or pause
  • {time} is given in milliseconds

  example curl.exe -X POST "localhost:3019/v0/jump-to-time/0?time=6000&state=pause"

  JUMP TO CUE

  • format "/v0/jump-to-cue/{tl_id}/{cue_id}?state={state}"
  • {tl_id} is timeline id
  • {cue_id} is cue id
  • {state} is play or pause

  example curl.exe -X POST "localhost:3019/v0/jump-to-cue/0/0?state=pause"

  SEND INPUTS

  curl.exe -X POST -H "Content-Type: application/json" http://localhost:3019/v0/inputs --data '[{"""key""": """Tomtar""", """value""": 0.5}]'

  get about timelines info

  curl localhost:3019/v0/timelines

  returns

  [ { "name": "Main Timeline", "id": "0" } ]

  get about timelines cues for a timeline

  curl localhost:3019/v0/cues/0

  returns

  [ { "name": "my cue", "id": "0" } ]

  LISTEN FOR PLAYBACK UPDATE EVENTS

  v0

  curl.exe http://localhost:3019/v0/sse

  or

  curl.exe http://localhost:3019/v0/ndjson

  returns a stream of

  data: {"type":"playbackState","clockTime":1718196220087,"timelines":[{"id":"0","running":false,"timelineTime":62950,"startDelay":0}],"freeRunningRenders":{}}

  data: {"type":"cueVisibility","clockTime":1718196220087,"cues":{"0_0":"Start"}}

  v1

  curl.exe http://localhost:3019/v1/sse

  or

  curl.exe http://localhost:3019/v1/ndjson

  returns current state and then a stream of updates

  data: {"type":"playbackState","clockTime":1718196220087,"timelines":[{"id":"0","running":false,"timelineTime":62950,"startDelay":0}],"freeRunningRenders":{}}

  data: {"type":"cueVisibility","clockTime":1718196220087,"cues":{"0_0":"Start"}}

  data: {"type":"playbackState","clockTime":1718196412628,"timelines":[{"id":"0","running":false,"timelineTime":61600,"startDelay":0}],"freeRunningRenders":{}}

  data: {"type":"cueVisibility","clock_time":1718196412628,"cues":{"0_0":"Start"}}

  CONTROL WATCHOUT 6 API

  ENABLE TCP (DEFAULT)

  • curl.exe -X POST http://localhost:3019/v0/compat/tcp

  DISABLE TCP UNTIL OPERATIVE RESTART

  • curl.exe -X DELTE http://localhost:3019/v0/compat/tcp

  GET TCP ENABLE

  • curl.exe -X GET http://localhost:3019/v0/compat/tcp

  ENABLE UDP (DEFAULT)

  • curl.exe -X POST http://localhost:3019/v0/compat/udp

  DISABLE UDP UNTIL OPERATIVE RESTART

  • curl.exe -X DELTE http://localhost:3019/v0/compat/udp

  GET UDP ENABLE

  • curl.exe -X GET http://localhost:3019/v0/compat/udp

  LEGACY PROTOCOL

  We implemented the old version 6 protocol in order to ensure a smooth transition with as less friction as possible. We tried to keep breaking changes to a minimum and all are clearly pointed out in this chapter.

  NOTE: We highly encurage you to use the new WATCHOUT protocol for new projects.

  Please refer to the original version 6 documentation for a detailed listing of available commands.

  DISPLAY COMPUTERS

  You can control your version 7 system like controlling the WATCHMAKER in version 6. The new service Operative acts like a version 6 system and is automatically started alongside the Director

  MAIN TIMELINE

  In Watchout 7 the concept of a Main Timline as been omitted. All timelines are treated equally. Commands previously controlling the main timline now look for a timeline called "Main Timeline". If you are using these commands make sure a timeline with this name exists.

  NOTE: Timelines called "Main Timeline" are now also included in the list of auxiliary timelines.

  SUPPORTED COMMANDS

  Command		Status
  gotoTime	✓	unchanged
  gotoControlCue	✓	unchanged
  reset	✓	unchanged
  setInput	✓	unchanged
  getInputs	✓	unchanged
  setInputs	✓	unchanged
  getAuxTimelines	✓	unchanged
  getControlCues	✓	unchanged
  ping	✓	changes
  run	✓	changes
  halt	✓	changes
  kill	✓	changes
  getStatus	✓	changes
  load	✓	changes
  enableLayerCond	🛇	ignored
  standBy	🛇	ignored
  authenticate	🛇	ignored
  online	🛇	ignored
  hitTest	🛇	ignored
  timecodeMode	🛇	ignored
  setLogoString	✖	unsupported
  serialPort	✖	unsupported
  getFile	✖	unsupported
  getStage	✖	unsupported
  list	✖	unsupported
  powerDown	✖	unsupported
  setRate	✖	unsupported
  wait	✖	unsupported

  CHANGED COMMANDS

  ping

  Response Parameter	Description version 6	Changes in version 7
  <string>	The version of the program.	-- unchanged --
  <string>	The name of the program.	always "WATCHMAKER"
  <string>	The name of the computer/OS.	"Windows", "MacOs", "Linux" or "Unknown"
  <bool>	License key is up to date.	currently always true
  [<string>]	Address of originator (empty or omitted if the origin is the conductor).	always omitted

  getStatus

  NOTE: The command takes two forms. version 7 supports both, only differences are listed here. When used without any parameter (deprecated), it provokes a responds with a Reply with the following parameters.

  Response Parameter	Description version 6	Changes in version 7
  <string>	Name of the show. Empty string if no show loaded.	currently the UUID of the show
  <bool>	Busy.	always false
  <uint>	Status of the show; 0: OK, 1: Suboptimal, 2: Problems, 3: Dead.	always 0
  <bool>	Display is open (i.e., in its full screen mode).	always true
  <bool>	Show is active (i.e., ready to run).	always true
  <bool>	Programmer is on line.	always true
  [<uint>]	Current time position, in milliseconds. Included only if show is active.	-- unchanged --
  [<bool>]	Show is running. Included only if show is active.	-- unchanged --
  [<float>]	Timeline rate. Nominally 1.0. Included only if show is active.	always 1 or 0
  [<bool>]	StandBy mode. Only included if show is active. Added in 4.1.1.	always false (might change in the future)
  [<uint>]	World time. Included only if show is active. Added in 5.2. May be very large, as the underlying data type is 64 bits. May not be entirely accurate when getStatus is used in polling mode - primarily intended for subscription mode usage.

  load

  Request Parameter	Description version 6	Changes in version 7
  <string>	Path to the show to be loaded	-- unchanged --
  [<uint>]	Conditional layer enable flags, least significant bit is condition 1.	-- unchanged --
  [<bool>]	Go online automatically. Defaults to true.	currently ignored since there is no offline mode yet

  run, halt, kill

  NOTE: In version 6 if the timeline name is not surrounded by double quotes, it reads the timeline name until the first space ignoring everything that follows eg. run Timeline 2 will try to run a timeline called "Timeline".
  This has changed in that the name is always read until the end of the line.

  Request Parameter	Description version 6	Changes in version 7
  [<string>]	Name of auxiliary timeline to run, pause or stop. No or empty name specifies main timeline	please read the section about the Main Timeline

  COLOR

  There are many different ways to represent colors. This chapter reviews some fundamental concepts related to representing colors in the digital world, and how to use this knowledge to make the most of colors in WATCHOUT.

  OVERVIEW

  Think of light as waves traveling through space; when these waves enter your eyes you may perceive colors and what colors you see, and if you see them at all, depends on the frequency of the light waves.

  One way to visualize the colors that are visible to humans is by using something called a color gamut. The primary purpose of a color gamut is to convey how many colors a specific input device, like a camera, or a specific output device, like a display, can capture or present.

  

  Color gamuts (License)

  The horseshoe-shaped area of the image represents the colors, or to be precise, the chromaticities, in CIE chromaticity coordinates, that are visible to the human eye. A chromaticity is basically a color disregarding its luminance.

  The colored triangles represent a subset of these colors, referred to as color spaces. For instance, there is one color space named sRGB. Although sRGB does not cover all the chromaticities visible to humans, it is still a widely used color space and works well to represent colors for a lot of scenarios.

  There are other color spaces that cover more chromaticities, such as Rec. 2020. The gamut for Rec. 2020 is larger than the gamut for sRGB and can thus represent a wider range of colors. One may wonder why sRGB is ever used instead of Rec. 2020, but to represent all colors inside the Rec. 2020. gamut, without sacrificing accuracy, you would need to use more bits per pixel, ie, more data. More data means that storage will require more HD space, and it also means that more data needs to be processed during playback.

  To know what color should be considered as "white" for a specific color space, the color space also defines something called a white point. In the image above there are two different white points, one labeled D65 used by Rec.2020, Rec.709 and sRGB, and another one labeled ~6300 used by DCI-P3.

  The colors inside a color gamut can be represented with something called a color model, which is a numerical representation of a set of colors. One of the most common color models is RGB where you combine a red, a green and a blue numeric value to represent a color. These three individual values are also referred to as color channels.

  

  RGB (License)

  Another common color model is HSV where you combine Hue (base color), Saturation (intensity) and Value (brightness) to represent a color.

  

  HSV (License)

  IMAGE/VIDEO COMPRESSION

  As the demand for more life-like images increases, the demand for higher color depth and resolution also increases. This means that devices, such as cameras and screens, and software, such as WATCHOUT, need to invent ways to efficiently handle a larger amount of data. One way to tackle this problem is through image/video compression, which involves strategies to efficiently store the pixels of an image or the frames of a video. When working with compression there are two important concepts:

  • Encoding which refers to the process of transforming color data from its original form to a more storage-efficient form.
  • Decoding which refers to the process of transforming encoded color data into another form.

  During encoding the accuracy of the data may decrease. This depends on which compression algorithm is used. If the algorithm is lossless, it means that no accuracy is being sacrificed. If the algorithm is lossy, it means it may remove data to pack the pixels more efficiently.

  CHROMA SUBSAMPLING

  The human eye is much better at perceiving variations in luminance compared to chrominance. Chroma subsampling is a compression technique that takes advantage of this fact by dividing the color information into two distinct parts, one to store the luminance of the color and another one for storing chrominance of the color.

  The luminance part is usually denoted Y' where the apostrophe implies that the luma has been gamma encoded. The chrominance part, which actually consists of two components, is usually denoted CbCr and stores chroma variations.

  There are different subsampling schemes and they are usually described by using a three-part ratio a:b:c (a fourth component may also exist if opacity is to be encoded), which defines how an image region is encoded.

  • a stands for the width in pixels of the region. It is usually 4.

  • b stands for the number of chrominance samples (CbCr) in the first row of the a pixels.

  • c stands for the number of chrominance changes between the first and the second row.

    • The chroma subsampling region always consists of two rows.

  • 4:4:4 indicates that each individual pixel in the block contains a unique color meaning that there is no data loss.

  • 4:2:2 is just like 4:2:0 with the exception that two samples for chrominance changes are stored between the first and the second row.

  • 4:2:0 indicates a region that is 4 pixels wide and for each of those pixels two chrominance samples are stored. There are no samples stored to express changes in chrominance between the first and the second row.

  • 4:1:1 indicates a region that is 4 pixels wide and for each of those pixels one chrominance sample is stored, and 1 chrominance change sample in the first and the second row.

  

  Chroma subsampling formats (License)

  TEMPORAL COMPRESSION

  Temporal compression looks at information between frames where consecutive frames are often very similar to each other, especially in scenes with no or gradual movement.

  The video compression algorithms analyze the movement between consecutive frames to identify areas that have shifted or changed. Once identified, motion compensation predicts the current frame based on the previous frame(s) and temporal compression typically involves compressing the differences between frames rather than each frame individually.

  There are different types of frames in a compressed video. There are I-frames which are complete frames meaning that all the information or pixels are there. These frames are also called keyframes, and they are encoded independently without reference to other frames. An I-frame is usually followed by one or more P-frames that store the pixels that have changed. There may also be frames called B-frames which is a special type of P-frame that looks both forward and backward for changes.

  The distance between I-frames is called a Group of Pictures (GOP) A GOP consists of a sequence of frames including a keyframe (or intra-frame) followed by a series of predicted frames (inter-frames). A video from YouTube might have a GOP of 300 frames.

  Media servers need an I-frame which is why, when jumping into such videos, it can take a while to get a full image and you even see the video step back.

  PIPELINE

  This chapter looks at how assets and their pixels, or rather colors, are transformed inside WATCHOUT. Although related to the Asset Manager chapter, this information places more emphasis on the color transformation taking place inside WATCHOUT.

  Below is an overview of the different stages an asset and its pixels go through before being shown to an audience:

  

  • Original

    • This is the first stage where you record/create/receive the original asset file that you want to visualize using WATCHOUT.
    • WATCHOUT supports a number of file formats and codecs which you can read more about here.
    • The quality of the original will have a big impact on the visual quality you can expect in the final stage.
    • Factors that affect the quality are:
      • Color space.
      • Resolution (the number of pixels in the image or video).
      • Frames per second (if it is a video).
      • The type of compression, if any, that was used when the asset was created.
        • Compression may reduce the accuracy of the colors in an image or video.

  • Asset Manager

    • The asset reaches this state when it has been added to the Asset Manager.
    • At this stage the asset can be transcoded to a different codec depending on the settings you have chosen in the Media Settings, which can be accessed from the Asset Manager file menu.
    • If the asset is transcoded from a codec using a color space with a wide color gamut to a more narrow color gamut you may lose color accuracy.
      • This depends on which colors are within the color space being used.
    • You may also lose quality due to compression.
    • It is important to understand that loss of quality might still be acceptable and a good trade-off to improve the playback performance.
      • Knowledge of the system capabilities where the WATCHOUT show will be played is key to making a good decision on this.
    • The settings inside Producer are deemed to be good defaults and therefore recommended. Only change these if you know what you are doing.
    • The end result of this stage can be referred to as the WO asset.

  • Visual Renderer

    • When the original asset has been processed and a WO asset has been created, it is ready to be sent to Visual Renderer.
    • The main goal of Visual Renderer is to output color accurate pixels at the right time and as fast as possible. This process includes the following steps:
      • Read the frame(s) of the asset as fast as possible.
        • Multiple frames are read in parallel to assure the data is available when it needs to be presented.
          • Disk and CPU clock speed, along with the number of assets that need be loaded at the same time, will affect how well this task can be performed.
      • Apply effects that have been assigned to the asset.
        • WATCHOUT strives to maintain color accuracy. The internal engine supports 16-bit color depth which should be enough for most use cases.
        • The effects are applied in linear Rec. 2020 color space as this allows more colors to be represented. Additionally, some effects may alter the color in a way that it could not be accurately represented with sRGB for instance.
        • In the Output section of the Display Properties you can select the output color depth and color space you want to use.
        • It is important to understand the capabilities of your output display/projector/device.
          • There is no point in trying to output colors in a configuration that is not supported by the output device.
      • Composite the pixels from an asset against assets already rendered.
      • Send the pixels to the next and final stage.

  • Display

    • This is the final stage of the pipeline and where the pixels are finally shown to the audience.
    • As outlined in the previous stage, the output can be configured in the Output section of the Display Properties.

  WHAT COLOR SPACE SHOULD I USE IN WATCHOUT?

  Imagine a scenario in which you want to show a commercial in a mall on a big screen. This "big" screen consists of 8 x 8 smaller screens that must play in sync. What color space should be deployed?

  The question is a bit too generic. You may have one color space for input (camera) and a completely different color space for output (display). Bear in mind that if you record using a narrow color space you generally have little to gain by using a wider color range for output, at least if the aim is to replay the content as close to reality as possible.

  So to answer this question, you need to first address other key questions:

  • What content do you want to show in the commercial?
  • From what distance will the audience view the content?
  • What color spaces are supported by the:
    • Camera used to shoot the commercial?
    • The screens that will be used?
    • Tool/software used to process the playback?
  • What frame rate and resolution do you want to use during playback and are the screens capable of reading, processing and displaying the pixels fast enough?
  • What effects do you want to use and how do these effects impact playback performance?

  The list goes on. As you can see there are many things that can affect this decision and it often boils down to trade-offs. For instance:

  • Are you willing to sacrifice frame rate for more vivid colors?
  • Are you willing to sacrifice color accuracy to be able to get smooth 60 FPS playback?

  So to conclude there is no clear-cut answer to this question. Experience and experiments will guide your way.

  APPENDICES

  WATCHOUT KEYBOARD SHORTCUTS

  GENERAL

  • Ctrl-O = Open a show file
  • Ctrl-S = Save show to disk
  • Ctrl-Shift-S = Save show to disk with new name
  • Enter = Open Properties window, if closed, or jump to Properties window
  • Ctrl-Tab or Ctrl-F6 = Cycle over all open windows left to right
  • Ctrl-Shift-Tab or Ctrl-Shift-F6 = Cycle over all open windows right to left
  • Ctrl-F4 = Close selected window

  EDIT

  • Ctrl-Z = Undo
  • Ctrl-Y = Redo
  • Ctrl-X = Cut
  • Ctrl-C = Copy
  • Ctrl-V = Paste
  • Delete = Delete
  • Ctrl-A = Select all
  • Ctrl-E = Select to end
  • Ctrl-M = Move stage position of selected cues/displays
  • Ctrl-F = Find
  • Ctrl-N = Snap (toggle)

  PROPERTY

  • Tab = Move keyboard focus to next field
  • Shift-Tab = Move keyboard focus to previous field
  • Ctrl-Wheel = Increase/decrease value in field
  • Ctrl-Shift-Wheel = Increase/decrease value in field more
  • Arrow-Up (in number property) = increment value
  • Shift-Arrow-Up (in number/slider/time property) = increment value more
  • Arrow-Down (in number/slider/time property) = decrement value
  • Shift-Arrow-Down (in number/slider/time property) = decrement value more
  • Alt (while with mouse over slider property) = show bigger slider

  STAGE & PREVIEW

  • Ctrl-Shift-D = Frame displays
  • Ctrl-Shift-O = Scroll to origin
  • Alt-Drag = Zoom scale to rectangle
  • Ctrl-Alt-Drag = To pan
  • Ctrl-Arrow = Nudge image of selected cue 1 pixel
  • Ctrl-Shift-Arrow = Nudge image of selected cue 10 pixels
  • Ctrl-1 = Preview scale 1:16
  • Ctrl-2 = Preview scale 1:8
  • Ctrl-3 = Preview scale 1:4
  • Ctrl-4 = Preview scale 1:2
  • Ctrl-5 = Preview scale 1:1

  CAMERA MODE NORMAL

  • A = Pan left
  • D = Pan right
  • W = Pan up
  • S = Pan down
  • Wheel = Zoom in/out

  CAMERA MODE FIRST PERSON AND PROJECTOR

  • A = Pan left
  • D = Pan right
  • E = Pan up
  • Q = Pan down
  • W = Pan forward
  • S = Pan backward
  • J = Orbit left
  • L = Orbit right
  • I = Orbit up
  • K = Orbit down
  • R-Mouse-Move = Orbit around
  • Arrow-Left = Move head left
  • Arrow-Right = Move head right
  • Arrow-Up = Move head up
  • Arrow-Down = Move head down
  • Wheel = Zoom in/out

  TIMELINE

  • Ctrl-T = Click jumps to time (toggle)
  • Ctrl-P = Add play control cue
  • Ctrl-Shift-P = Add pause control cue
  • Ctrl-I = Insert layer
  • Ctrl-Delete = Delete layer
  • Ctrl-G = Group cues into composition
  • Ctrl-Shift-G = Ungroup cues
  • Spacebar = Start timeline (toggle)
  • Esc = Pause timeline (no toggle)
  • NUM 0 = Start timeline (no toggle)
  • ***NUM **** = Jump to last start position
  • NUM + = Magnify timeline scale
  • NUM – = Reduce timeline scale
  • Ctrl-Arrow-Keys = Nudge image of selected cue 1 pixel
  • Ctrl-Shift-Arrow-Keys = Nudge image of selected cue 10 pixels
  • Ctrl-Wheel = Scroll timeline horizontally
  • Shift-Wheel= Move timeline marker 0.1 second
  • Ctrl-Shift-Wheel = move timeline marker 1 second
  • Arrow-Up = Select layer above
  • Arrow-Down = Select layer below
  • Arrow-Left = Select previous cue in layer
  • Arrow-Right = Select next cue in layer
  • Shift-Drag = Move a cue vertically without changing time

  EFFECT

  • Alt-Shift-I = Fade-in
  • Alt-Shift-O = Fade-out
  • Alt-Shift-X = Cross-fade
  • Alt-P = Position
  • Alt-S = Scale
  • Alt-O = Opacity
  • Alt-B = Gaussian Blur
  • Alt-C = Crop All Sides
  • Alt-Z = Rotation Z-Axis
  • Alt-Y = Rotation Y-Axis
  • Alt-V = Volume

  DISPLAY

  WARP

  • Arrow-Up = Select next warp point above
  • Arrow-Down = Select next warp point below
  • Arrow-Left = Select next warp point to the left
  • Arrow-Right = Select next warp point to the right
  • Ctrl-Left-Click = When pointing at a line, add a warp point

  XBOX CONTROLLER

  • LEFT JOYSTICK = Move the selected point dynamically in X/Y
  • D-PAD = Move the selected point exactly one pixel in X/Y
  • RIGHT JOYSTICK = Select next point in X/Y, this can be central point or bezier handles points
  • RB = If multiple Warp windows are open, jump to previously selected window
  • LB = If multiple Warp windows are open, jump to next selected window
  • X = Undo last step
  • Y = Redo last step

  For more information look in Appendices / XBox Controller

  Terminology/Acronyms

  • NUM = Keys on the number pad of your keyboard
  • Arrow = The arrow keys on your keyboard
  • Drag = Dragging by clicking the primary (left) mouse button and moving the mouse
  • Delete = The Delete key on you keyboard, also labeled Del
    (Not to be confused with backspace or <-)
  • Enter = The Enter key on your keyboard
  • A - Z = Letters found on your keyboard
  • F1 - F12 = The function keys found at the top of your keyboard
    (On some keyboards you have to hold down the Fn key for these.)
  • Wheel = The scroll wheel of your mouse

  XBOX CONTROLLER

  You can use a standard XBox type of game controller to do the warp settings more easily and intuitively in WATCHOUT. Any controller that emulates the standard XBox model will most likely work but be aware that some controllers behave differently and may lack some of the functionality that WATCHOUT relies on.

  

  Button	Action
  LEFT JOYSTICK	Move the selected point dynamically in X/Y
  D-PAD	Move the selected point exactly one pixel in X/Y
  RIGHT JOYSTICK	Select next point in X/Y, this can be central point or bezier handles points
  RB	If multiple Warp windows are open, jump to previously selected window
  LB	If multiple Warp windows are open, jump to next selected window
  X	Undo last step
  Y	Redo last step

  NETWORK

  PORTS

  BASIC

  Process	port
  RUNNER	3018
  MANAGER	3017
  DIRECTOR	3021
  ASSET MANAGER	3023
  OPERATIVE INTERNAL	3020

  EXTERNAL COMMUNICATION

  Process	port
  OPERATIVE EXTERNAL	3019
  LOKI	3022
  OSC	8000
  Art-Net (DMX)	6454
  LEGACY PROTOCOL	3039, 3040

  MULTICAST DISCOVERY

  IP	239, 2, 2, 2
  QUERY PORT	3011
  RESPONSE PORT	3012

  HARDWARE RECOMMENDATIONS

  There are recommendations for the computers running WATCHOUT Producer and WATCHOUT Manager to ensure smooth performance in show preparation and operation.

  NOTE: The requirements will be updated continously.

  PRODUCER

  The computer running the Producer software should have the following minimum system requirements.

  • Windows 10 or above
  • WATCHOUT version 7 is a 64-bit application
  • GPU required API is Vulkan 1.3
  • CPU supported AVX instruction set

  TESTED PRODUCER HARDWARE

  NVIDIA GPUs

  • Pascal Quadro series and later AMD discrete GPUs
  • AMD Radeon Pro Vii (driver: AMD software: Pro edition 23.Q1.1)

  AMD integrated GPUs

  • AMD RX Vega (AMD Ryzen 7 4700U)
  • AMD Radeon Graphics (AMD Ryzen embedded V2718)

  VISUAL RENDER

  • Windows 10 or above
  • WATCHOUT 7 is a 64-bit application
  • GPU required API are openGL 4.4 / DirectX 11
  • CPU supported AVX instruction set

  TESTED VISUAL RENDERER HARDWARE

  NVIDIA GPUs

  • Pascal Quadro series and later

  WATCHPAX MEDIA SERVERS

  The Dataton WATCHPAX range of servers are optimized for WATCHOUT playback. WATCHPAX 40, 42, 60 and 62 media servers can be upgraded to WATCHOUT version 7. WATCHPAX servers shipped from October 2023 will have the upgrade already applied.

  The WATCHOUT version 7 upgrade for WATCHPAX 40, 42, 60, 62 servers is a license upgrade and a new image file will have to be installed. Please contact Dataton or your local Premium Partner for information on this process.

  CUSTOM SERVERS

  If you have an AMD graphics card, use Windows 10 as AMD has not released drivers for Windows 11, at the time of writing. If you intend to install and use Dante® then ensure there is no WIFI card, or disable any WIFI cards.

  ASSET MANAGER

  The Asset Manager should have a large, fast hard drive or multiple drives, as well as a GPU that supports Vulkan 1.3. This is where you store your media files which may be both large and numerous. As a rule of thumb, double up the amount of storage capacity you think you will need.

  NETWORK

  The computers running the Producer and Manager software must be connected using an ethernet network. A typical system has 1 Gigabit ethernet network ports on all computers and a high-quality ethernet switch with the required number of ports to connect the computers.

  NOTE: A wireless network may work but is generally not recommended for reliability reasons and affects synchronization accuracy among display computers.

  AUTOSTART

  To setup WATCHOUT Manager to autostart on login, you can use the schtask.exe command. You need to run the command in a cmd-window with administrator privileges.

  Click on the Windows logo, bottom left, and type cmd.exe, then select Run as administrator (see image below).

  
  

  

  
  

  When the cmd-window is open, change directory to the WATCHOUT installation directory with the
  cd C:\watchout7 command.

  Type this line in the cmd-window:

  schtasks.exe /create /tn "WATCHOUT manager" /xml c:\watchout7\wo-autostart.xml

  If you have installed WATCHOUT in a different location than c:\watchout7, edit the xml file accordingly.

  To edit scheduled tasks in more detail you can run the following command:

  run taskschd.msc

  The wo-autostart.xml file is located in the WATCHOUT installation folder.

  SETTING UP YOUR SERVER

  MAKE SURE THINGS ARE UP TO DATE

  • Are you using the latest graphics driver?
  • Are you using an up to date webview2?
  • Have you installed Media Feature Pack (for N and KN versions of Windows 10)?

  TIPS

  On your display nodes you will benefit from:

  • Running as few programs as possible.
  • Turning off notifaction and popup programs.
  • Turning off explorer (taskkill /im explorer.exe /f).
  • Setting the priority of visual renderer (from task manager, or when starting or using wmic).

  WATCHOUT 7 QUICKSTART GUIDE

  INSTALLATION

  WATCHOUT is Microsoft Windows-based software and is downloaded from Dataton website https://www.dataton.com/downloads

  WATCHOUT can be installed on a Windows PC running Windows 10 and above. The software installation consists of:

  • WATCHOUT Manager (contains Runner and Asset Manager)
  • WATCHOUT Producer (contains Producer software)

  To start using WATCHOUT it has to be first installed on every computer that will be used in your show. The installer is universal and will deploy both the producer components and the display server components.
  
  

  Start the installation by double-clicking on the WATCHOUT 7 installer.
  Please select all components you would like to use and specify the destination folder for the installation.

  

  • Services: Contains all base functions.
  • LTC Bridge: External app for LTC Input.
  • MIDI Bridge: External app for MIDI input.
  • ArtNet: External app for recording ArtNet universes.

  STARTING UP

  PRODUCTION SETUP

  To start WATCHOUT Producer just find the shortcut on desktop or start it directly from the installation destination. Additional services (WATCHOUT Manager) will be started automatically.

  

  C:\WATCHOUT7\bin\Producer.exe

  Note: The Producer has to be run with Windows administrator privileges.

  DISPLAY SETUP

  To start WATCHOUT on the display server just find WATCHOUT Manager shortcut on desktop after installation.

  

  C:\WATCHOUT7\process-manager.exe

  Note: The Manager has to be run with Windows administrator privileges.

  On a computer that will be used as a display server, video rendering will start automatically after the display is added to a show and enabled.

  SHOW DEPLOYMENT

  The entire show is programmed from the Producer software, there is no setup or configuration required on the display end, other that it has to be running and accessible on the network.

  SETTING UP A NEW SHOW

  Start the Producer and select the New Show option on the welcome screen.

  

  
  

  Every WATCHOUT show requires a Director which will maintain current show, version handling and propagation of changes to all connected display servers. By default the Director role will be assigned to a local host (the same machine that is running Producer). Current Director and Asset Manager assignments are indicated in the top right of the menu bar.

  

  
  

  To assign Director and Asset Manager roles to a different host, find the desired WATCHOUT node in the Devices list and assign the role from the context menu (right-click).

  

  
  

  Displays can be added by selecting the desired node in Devices.

  

  
  Or directly from Stage.

  

  
  

  To correctly address the display, select the desired node from the dropdown list and hit the enable button (heart).

  

  
  

  To help identify the display, render information can be used. This will show the name of display along with most important properties.

  

  
  At this point the show is live and any content added to the Stage will be sent to display servers and immediately rendered.

  HANDLING MEDIA

  • Add media
  • Optimizing explanation
  • Add assets to show
  • See asset on display

  SUMMARY

  • General tips

  GLOSSARY

  This section lists some common terms that are used when working in WATCHOUT.

  ALPHA CHANNEL

  Refers to a color channel that stores information on the transparency or opacity of a pixel. If the alpha value is set to 0 (zero) it is completely transparent and if it is set to 1 (one) it is opaque.

  AUDIO BUS

  An audio bus is a virtual mono path collecting tracks from one or more audio cues and transmitting onto one or more output device channels. The available buses in the system are numbered from 1 and upwards, but can also be assigned names. By default buses 1 and 2 have the names Left and Right. The available buses are visible in the channel mapping sections of the Cues and devices.

  AUDIO DEVICE

  An audio device is a device capable of playing sound. An audio device is controlled by a Runner, and can be of type WASAPI, WASAPI exclusive, Dante or ASIO. A WASAPI, WASAPI exclusive or ASIO device is always hosted on the same machine as the Runner, either built-in, or connected via USB. A Dante device is attached to the network, but controlled by a Dante controller on the Runner's device. An audio device can have one or more channels.

  AXIS GIZMO

  An axis gizmo is generally used to move, scale and rotate objects in 3D editors.

  BITS PER PIXEL

  Refers to the number of bits used per pixel, which is shortened as bpp. If an image consists of pixels that use 8-bits per channel, and there are three channels per pixel, it is considered to be a 24 bpp image.

  CHANNEL MAPPING

  Channel mapping is the process of mapping audio cue channels to audio device channels. This is done in two stages: first in the Cue properties window where the cue channels are mapped to audio buses, then in the Audio Properties window, where the audio buses are mapped onto audio device channels.

  CHROMATICITY

  Refers to the color without taking into account luminosity.

  CHROMINANCE

  Refers to the color in relation to luminosity.

  CODEC

  Refers to a device or software that can be used to encode and decode a data stream.

  COMPRESSION

  Refers to techniques used to reduce the size of data, such as an image or video.

  COLOR BIT DEPTH

  Refers to the number of bits used per color channel for a pixel. If a color channel consists of 8-bits, each channel can represent 256 different values. Three 8-bit channels can represent 256^3=16777216 different colors. This value is referred to as the color depth.

  COLOR CHANNEL

  Refers to a specific component of a color model. RGB consists of a red, green and blue channels.

  COLOR DEPTH

  Refers to the number of colors that can be represented in an image. It is often used to convey how many colors a specific input/output device can handle and is related to color bit depth.

  COLOR GAMUT

  Refers to all chromaticities that can be represented by a specific output or input device.

  COLOR MODEL

  Refers to a numerical representation of a color. Examples include RGB, HSV and CMYK.

  COLOR SPACE

  Refers to a constrained space in which you can represent a set of colors. Examples include sRGB and Rec.2020.

  EDID

  Stands for Extended Display Identification Data which is used to share display properties between different devices. For instance, it can be used to let a GPU know what computer screen is currently connected.

  GAMMA CORRECTION

  The human eye is much better at perceiving differences between dark colors compared to bright colors. This is exploited when storing and displaying image data. The concept called gamma correction may refer to both gamma encoding and decoding.

  GAMMA ENCODING

  Refers to transforming image data in a way where more bits (more data) is used for darker colors and fewer bits (less data) is used for brighter colors.

  GAMMA DECODING

  Refers to reversing the gamma encoding operation which means a color is transformed from its encoded value to its original value.

  HDR

  HDR, which stands for High Dynamic Range, refers to a set of techniques that allow for a greater range of luminance levels between the darkest and brightest parts of a video image compared to standard dynamic range (SDR) video.

  LOSSLESS COMPRESSION

  Refers to a compression technique that reduces the size of data, such as an image or video, without sacrificing any quality.

  LOSSY COMPRESSION

  Refers to a compression technique that reduces the size of data, such as an image or video, where quality/accuracy is often sacrificed for greater reduction in size.

  LUMA

  Refers to the brightness or grayscale intensity of an image.

  LUMINANCE

  Refers to a photometric unit used to describe the brightness of light.

  MESH

  A mesh is a surface composed of a set of connected polygons.

  POLYGON

  A polygon is a surface defined by three or more vertices. In WATCHOUT each polygon is always a triangle and thereby defined by three vertices. Sometimes polygons are also referred to as faces or triangles.

  SDR

  SDR, which stands for Standard Dynamic Range, refers to the standard range of luminance levels between the darkest and brightest parts of a video. It cannot represent the same amount of color detail compared to a high dynamic range (HDR) video.

  TEXTURE

  A texture can be thought of as an image that is to be applied to a mesh surface.

  UNIFORM SCALING

  Uniform scaling means that x, y and z are scaled equally.

  UV-COORDINATE

  UV-coordinates are used to map an image/texture onto a polygon. UV-coordinates are also sometimes referred to as texture coordinates.

  VERTEX

  A vertex is a point in space. Three vertices form a triangle/polyon in a mesh.

  WHITE POINT

  Refers to a point in a color gamut that is used as a reference color for white.

  WIREFRAME

  Wireframe rendering means that each polygon edge is rendered as a visible line. The intention with this render mode is often to get a better understanding about the topology and polygon density of a mesh.