Documentation Center

Viz Artist

Version 3.11.0 | Published January 22, 2018 ©

Graffiti

images/download/attachments/27789859/viz_icons_graffiti.png
The Graffiti scene plug-in allows telestration on top of scenes in the screen space. Telestration is done by drawing with a brush shape using a mouse or a 6DOF interface. The plug-in can also recognize some rendered shapes and replace the hand-drawn items with the recognized shapes (e.g. circle, ellipse, cross, arrow).

The graffiti scene plug-in is not intended for use on video output. To use graffiti textures on video output, use the GraffitiTex container plug-in.

Note: This plug-in is located in: Built Ins -> Scene plug-ins -> Texture

This section contains information on the following topics:

Graffiti Properties

images/download/attachments/27789859/plugins_scene_graffiti_editor.png

  • Active: Enable/disable drawing.

  • Pointer Source: The plug-in supports input from the mouse, or from another plug-in via a dispatcher interface. This button selects whether the plug-in will listen to the mouse or the dispatcher for input.

  • Mask Container: This points to either a container or a group of containers. These containers mask the area over which the brush is rendered.

  • Alpha: Transparency of the brush.

  • Key: Selects whether the brush is rendered in the key signal

  • Brush Type: Color or eraser brush.

  • Brush Image: Optional image that will determine the shape of the brush. If empty, a round brush will be used.

  • Brush Width: Width of the brush in pixels. Visible only if the color brush is selected.

  • Eraser Brush Width: Width of the eraser in pixels. Visible only if the eraser brush is selected.

  • Brush Color: Color of the brush.

  • Recognize Shapes: Shape recognition mode (on/off).

  • Recognize Ellipse: Specifies whether shape recognition will try to recognize ellipse shape.

  • Recognize Circle: Specifies whether shape recognition will try to recognize circle shape.

  • Recognize Cross: Specifies whether shape recognition will try to recognize cross shape.

  • Shape Delay: Number of frames to wait from mouse up before trying to recognize shapes.

  • Draw Arrow: Specifies whether non-recognizable shapes will be converted to an arrow.

  • Arrow Length: Length of arrow head.

  • Arrow Width: Width of arrow head.

  • Circle Rad: Radius of the circle replacing a recognized circle. If zero, the radius of the recognized circle will be used.

  • Cross Width: Width of the cross replacing the recognized cross shape. If zero, the width of the recognized cross shape will be used.

  • Max. Undos: Max number of undo operations.

  • Clear (button): Clears the canvas.

  • Undo (button): Undo.

To Create a Scene Level Graffiti Effect

images/download/attachments/27789859/plugins_scene_graffiti_scene_example.png

  • Add the plug-in to the Plug-in Panel in Scene Settings, set the plug-in properties, set Viz Artist in On Air Mode and start drawing.

6DOF (6 Degrees of Freedom)

6DOF is a tool for artists, script writers and plug-in developers to position and orientate objects in the 3D space (3 translation and 3 rotation axis => 6DOF).

6DOF works directly with the built in Scene-Grids (see Grid Tool-bar) and uses them to calculate the intersection of the projected user input (mouse or touchscreen position) with the current grid plane. As soon as a touch or click input is detected, it triggers the corresponding 6DOF callbacks (OnButtonDown6DOF, OnMove6DOF, etc...) and passes the calculated position and rotation.

images/download/attachments/27789859/plugins_scene_6dof_example.png
For example: This could be used to move players on a football field interactively without doing any maths at all.

Additionally, 6DOF has a distribution mechanism which can send the user input to multiple engines, at the same time. This is configured in the Global Input of the Viz Configuration (see the Viz Engine Administrator Guide)

See Also