Viz Arc User Guide

Version 2.0 | Published July 03, 2024 ©

Scene Action Types

Import from a scene/stage tree and edit parameters of these supported types:

Alpha

Alpha lets you set the opacity to the referred object, from 0.0 (not visible) to 100.0 (fully visible).

images/download/attachments/154395249/arc_sat_alpha.jpg

Control Channel

Control Channel lets you control basic Control Channel types such as floats, integers, and Boolean values. This can be particularly handy in conjunction with the Viz Engine 4 Render Graph.

images/download/attachments/154395249/image2021-1-26_23-38-15.png

To create a Control Channel action, drag and drop a Control Channel to the action canvas:

images/download/attachments/154395249/image2021-1-26_23-45-35.png

If more than one parameter needs to be controlled by the same action, edit the action and drag more parameters into the designated area:

images/download/attachments/154395249/image2021-1-26_23-48-45.png

or use the ADD button to select from a list of available Control Channels to be added:

images/download/attachments/154395249/image2021-1-26_23-50-20.png

To remove Control Channels from the action, click the Expand button and use the context menu to delete single Control Channels in the newly opened window:

images/download/attachments/154395249/image2021-1-26_23-51-37.png

Control Objects

Control Object actions can be used by dragging a Control Object plug-in from the scene tree into the action canvas. It gives you a list of the Control Objects under the respective tree structure.

images/download/attachments/154395249/controlobjects_new.png

Expand the controls clicking the Expand button for a better overview and to enable deletion of single or multiple Control Objects. Select all the controls that shall not be set by this action, then select Delete from the context menu.

images/download/attachments/154395249/cofullwindow.png

Use the Refresh button to update the list from the associated scene, in case the scene has been modified after the action's creation.

images/download/attachments/154395249/co_enabled.png

In some cases you might want to send only a subset of the entire Payload. Use the Enabled toggle flag for each Control Object to enable or disable setting the specific property on the Viz Engine. It behaves similar to the delete option described above, but in this case you can re-enable the disabled Control Object easily.

ControlObjects in Unreal Engine

The Viz Engine's Control Object integration allows you to control aspects of the Unreal scene using Control Objects. Viz Engine's Control Objects can be used to ingest images from the Graphic Hub to the Unreal Engine.

images/download/attachments/154395249/unrealCO.png

Control Objects can be refreshed within the Viz Engine by using the Refresh UE Control Objects fetching the exposed controls of the currently loaded Unreal Level.

images/download/attachments/154395249/invizengine.png

Director

Director lets you handle stage animation of a specific stage director or ALL stages.

images/download/thumbnails/154395249/directoreditaction.png
It’s possible to:

images/download/thumbnails/154395249/arc_sat_astart.jpg

START an animation.

images/download/thumbnails/154395249/arc_sat_astop.jpg

STOP an animated director.

images/download/thumbnails/154395249/arc_sat_acon.jpg

CONTINUE an animation to the next step.

images/download/thumbnails/154395249/arc_sat_asr.jpg

START in REVERSE mode.

images/download/thumbnails/154395249/arc_sat_acr.jpg

CONTINUE in REVERSE mode.

images/download/thumbnails/154395249/arc_sat_playf.jpg

PLAY FROM a specific KEYFRAME.

images/download/thumbnails/154395249/arc_sat_playfr.jpg

PLAY FROM a specific keyframe in REVERSE mode.

images/download/thumbnails/154395249/arc_sat_playft.jpg

PLAY an animation FROM a specific KEYFRAME TO another.

images/download/thumbnails/154395249/arc_sat_set.jpg

SET an absolute time in seconds and jump (GO TO) tag/stop points.

images/download/attachments/154395249/arc_sat_stft.jpg

This menu lets you set the Stop/Tag for PLAY FROM, PLAY FROM REVERSE and GO TO options, and the Frame Time for the CUSTOM option.

images/download/thumbnails/154395249/arc_sat_ftst.jpg

This menu lets you set the From stop/Tag and To Stop/Tag for playout of an animation for the FROM TO option.

The Director Action shows the number of stop points when a specific director is selected (for example, not the <STAGE>). When the action is selected, a progress bar on top alongside with the currently reached stop point (for example, 2/3) is visualized. The number of stop points is read on the creation of the action and when the action is explicitly refreshed.

images/download/attachments/154395249/stoppointsdirectorprogress.png

Geometry

Use this menu to set an OBJ or SCENE element in a specified container.

images/download/attachments/154395249/arc_sat_geom.jpg

images/download/attachments/154395249/geom2.png

Clicking Select Geometry or Scene makes all GH trees appear in a new window, where you can select a new GEOM.

images/download/attachments/154395249/arc_sat_obj.jpg

Selecting OBJECT makes the relevant thumbnail appear in the action box.

images/download/attachments/154395249/geom3.png

It’s also possible to select a SCENE instead of GEOM. Once the scene is loaded in the geom plugin, a separate edit section appears where it's possible to handle control object (if applicable) of the selected scene.

To Import a Geometry

In Viz Arc, it's possible to import objectified scenes (GEOM) into another scene through the GEOMETRY element. Once the selected object is imported in the right GEOM, it's possible to load, update, refresh and continue. A step-by-step example of importing and playing an objectified scene follows below:

images/download/thumbnails/154395249/geomhowto0.png

Load a main scene that contains at least one GEOM element.

images/download/attachments/154395249/arc_sat_geoht.jpg

Drag the GEOM element into the main area.

images/download/attachments/154395249/arc_sat_geoht2.jpg

Press Edit and select the scene.

images/download/attachments/154395249/geomhowto3_14.png

Once you select the scene, a list of control objects appears (if applicable). You can enable the RESET STAGE option to have the scene placed on the 0.0 frame in the stage.

images/download/attachments/154395249/arc_sat_geoht4.jpg

You can edit every control object listed in the scene.

images/download/thumbnails/154395249/geomhowtoEXPANDwindow.png

You can use the images/download/thumbnails/154395249/arc_sat_geohtx.jpg icon to open a popup window that contains a detailed list of control objects, where you can modify each field by clicking it.


Once you have created your action box, you can duplicate it by pressing CTRL +D and assign a different action (LOAD, UPDATE, RESET, CONT) to each box. Follow the steps below to play the GEOM scene in the main scene:

images/download/thumbnails/154395249/arc_sat_gl.jpg images/download/attachments/154395249/arc_sat_glc.jpg

This command loads the scene/object in geom.

If images/download/thumbnails/154395249/arc_sat_rson.jpg is enabled, the scene/object is loaded with all its stage animation set to frame 0.

If images/download/thumbnails/154395249/arc_sat_rsoff.jpg is disabled, it works like a Take command, loads and start stage.

images/download/thumbnails/154395249/arc_sat_gu.jpg images/download/attachments/154395249/arc_sat_guc.jpg

This command updates all changed control objects On Air.

images/download/thumbnails/154395249/arc_sat_gr.jpg images/download/attachments/154395249/arc_sat_grc.jpg

This command initializes the stage (frame 0.0).

images/download/thumbnails/154395249/arc_sat_gc.jpg images/download/attachments/154395249/arc_sat_gcc.jpg

This command plays the scene. If the scene has multiple animation steps, you can continue the animation by clicking it multiple times.

For LOAD, RESET and CONTINUE, you can choose a specific director instead of the full stage. images/download/attachments/154395249/arc_sat_sol.jpg

images/download/attachments/154395249/arc_sat_x.jpg

Light

The light action works together with Viz Engine V4 lights. All light types are supported (directional, area, spot, point).

images/download/attachments/154395249/lightaction.png

The Position and Orientation settings can be optionally set and act on the container transformation.

Material

The Material menu lets you set the material of an element and its Shininess and Alpha. Set a unique color or set every color to Ambient, Diffuse, Specular, Emission lighting by enabling/disabling the E button next to the lighting tabs.

images/download/attachments/154395249/arc_sat_mat.jpg

  • Ambient: Determines the color that the object reflects when illuminated by a natural ambient light.

  • Diffuse: Determines the real color of the object, revealed when the object is illuminated by a neutral light.

  • Specular: Determines the color that the object has when the light meets the object surface and reflects in the camera.

  • Emissive: Determines the self-illumination color.

You can import an existing material in GH (Graphic Hub) by pressing the Load from GH button.

Image

Image lets you select an image, both from GH tree and external explorer files, and set basic transformation parameters like Position, Rotation, and Scaling of the image texture.

images/download/thumbnails/154395249/arc_sat_img.jpg

images/download/thumbnails/154395249/arc_sat_imgb.jpg

Once in edit mode, click image to browse the database and select an image from Graphic Hub.

images/download/thumbnails/154395249/arc_sat_imgbhl.jpg

Once in edit mode, click the folder icon images/download/thumbnails/154395249/arc_sat_browse_ico.jpg at the bottom of the image box to browse the file system and select an image from your PC or device.

images/download/thumbnails/154395249/arc_sat_imgp.jpg

To see the image path, hover your cursor over it.

With a properly configured Viz One or Viz Media Service, assets can be picked from those sources in addition to local files or Graphic Hub. It is possible to search for assets within Viz One using the search box. images/download/attachments/154395249/vizonbrowser.png

Key

images/download/thumbnails/154395249/key.png

Use the Key menu to handle Key options for a container:

images/download/thumbnails/154395249/arc_sat_drgb.jpg

Draw RGB

images/download/thumbnails/154395249/arc_sat_dkey.jpg

Draw Key

images/download/thumbnails/154395249/arc_sat_cwck.jpg

Combine with BG Chroma Key – combines the alpha of the container with the alpha of the background before blending the foreground with the background.

images/download/thumbnails/154395249/arc_sat_dio.jpg

Depth Info Only – depth only for occlusion rendering with Live Video.

images/download/thumbnails/154395249/active2.png

Active - shows if the Key plugin is active or inactive. Typically used in a green screen scenario to determine whether an object should appear in front of or behind the talent.

Omo

Use this menu to adjust the Omo plug-in settings:

images/download/attachments/154395249/arc_sat_omo.jpg

This plug-in displays all sub-containers, either one at a time or by keeping the previous container visible until the selected container appears (by enabling the Show until parameter). The Visible Container parameter determines which sub-container is displayed.

Note: For more on the Viz Omo Plug-in, see the Viz Artist User Guide.

PBR Material

The PBR Material action works together with Viz Engine V4 materials.

images/download/attachments/154395249/pbr.png

The action offers a subset of Viz Artist's PBR settings, exposing only the most prominent features, such as all textures and colors defining the PBR material.

Enable the Set Textures Only checkbox to send texture information only, use the respective checkboxes on the various attributes to send to enable or disable them.

Use drag and drop from any image assets to copy and paste a texture asset to another slot.

images/download/attachments/154395249/image2020-4-3_19-26-3.png

When the GH Mode is selected, you can browse Graphic Hub for PBR materials and load them through this action.

The action can be executed in two modes: Pre-Load or Load. Pre-Load preloads all the images present in the action on the Engine. Load effectively loads the PBR Material onto the Engine. Typically, you group all Pre-Load actions and execute them on Initialization, then trigger only the Load actions. Right clicking the action execute button always sends Pre-Load commands.

images/download/attachments/154395249/preloadPBR.png

The screenshot above shows two PBR actions in an initialization group as pre-loading and the same actions on the right for loading.

Phong

The Phong Material action works together with Viz Engine 4.3 and newer.

images/download/attachments/154395249/phong.png

The action offers a subset of Viz Artist's Phong material settings, exposing only the most prominent features, such as all textures and colors defining the Phong material.

When GH Mode is selected, you can browse Graphic Hub for Phong materials and load them through this action.

Analog to the PBR Material, the action can be executed in two modes: Pre-Load or Load. Pre-Load preloads all the images present in the action on the Engine. Load effectively loads the Phong Material onto Viz Engine. Typically, you group all Pre-Load actions and execute them on Initialization, then trigger only the Load actions. Right clicking the action execute button always sends Pre-Load commands.

Enable the Set Textures Only checkbox to send texture information only, use the respective checkboxes on the various attributes to send to enable or disable them.

Use drag and drop from any image assets to copy and paste a texture asset to another slot.

Script

The Script action lets you modify the registered UI parameters of a Viz Engine container script. Additionally, it lets you invoke any of the script's functions with its respective parameters.

images/download/attachments/154395249/enginescript.png

An example of a container script UI in Viz Artist.

images/download/attachments/154395249/scriptactionall.png

Drag and drop a Script container plug-in from the tree view into the action canvas to create a Script Action.

images/download/thumbnails/154395249/addfunction.png

Click on the ADD FUNCTION INVOCATION button to add any of the script's functions to the action.

images/download/attachments/154395249/addfunctions.png

After adding the functions you whish to invoke, enter the parameters where necessary. A hint in the parameter's text box in the parameter gives you the signature of the function.

images/download/attachments/154395249/addfunctionswithparams.png

Note: Parameters need to be separated by a space character. When strings containing spaces are passed as parameters, use the quote " character as a delimiter of the string as in the "Hello World" sample above.

On execution of the Script Action, all UI parameter values and function invocations listed in the action are sent to the selected channel's Viz Engine(s).

images/download/attachments/154395249/decimatedscriptaction.png

Use the small trash icons on the right hand side of each row to remove parameters that you don't want to send to the Viz Engine. Press the refresh icon to reload the script from the Viz Engine's scene. Make sure the scene is loaded on the Editing Engine.

Text

This menu lets you set text in the selected container. The action supports standard text geometry as well as Text introduced in Viz Engine 4.3.

images/download/attachments/154395249/arc_sat_text.jpg

Transformation

Transformation lets you set position, rotation and scaling of the selected container. You can also scale in proportion by clicking the Lock icon images/download/thumbnails/154395249/arc_sat_lock_ico.jpg next to the scaling panel. Position, Rotation and Scaling can be disabled using the check boxes. When disabled, those parts are not being sent to the Engine on execution. For example, when selecting Rotation only, only the rotation of the target container is affected on execution.

images/download/attachments/154395249/arc_sat_transf.jpg

It's possible to create a linked action for TRANSFORMATION actions. This option is useful for controlling different scenes with the same tree structure, for example.

To Create a Linked Action

Linked actions are useful for controlling different scenes with the same tree structure, for example.

images/download/thumbnails/154395249/arc_sat_cla.jpg

Right-click on the panel and select Create Linked Action (or ALT + drag on an action box).

images/download/thumbnails/154395249/arc_sat_laicos.jpg

A new action box, cloned from the original one, is displayed. Both boxes have the linked icon at the top left corner.

images/download/thumbnails/154395249/arc_sat_laico2.jpg

The linked icon also appears on the box saved in the favorite area, if applicable.

images/download/thumbnails/154395249/arc_sat_law.jpg

Any changes that are now made to one of the related boxes affects them all, until the clones are removed.

Viewport

images/download/attachments/154395249/viewportdragdrop.png

Drag and drop a Viewport container plug-in from the tree view into the action canvas to create a Viewport Action.

images/download/attachments/154395249/viewportaction.png

Specify the Scene to be loaded to be loaded into the viewport or Clear Scene to clear the currently loaded scene of the viewport. Select Reset Stage to reset the stage on scene load. Camera ID selects the camera to be used within the viewport scene.

When Virtual Window is checked the selected position, rotation and width and height are sent to the viewport plug-in.

Visibility

images/download/attachments/154395249/visonof.png

Use the visibility menu to toggle a container on or off. The container can be set to ON, OFF, DUAL or toggled (switched to the opposite of the current state).

images/download/attachments/154395249/visdual.png

When DUAL mode is selected, left clicking Execute switches the container on and right clicking switches the container off. In the Dual mode colors section, two distinct colors can be defined for on and off states in order to make the state of the container more visible.

See Also