Plug-ins User Guide

Version 5.2 | Published March 20, 2024 ©

MoViz

images/download/thumbnails/114312562/ico_moviz.png
With the MoViz plug-in media files or streams can be played inside the Viz Engine.

MoViz is not a QuickTime player or an AVI player. It uses the Microsoft DirectShow Filter Graph framework to play the media files, which means it can play both types, but only certain installed Filter Graphs (some of the QuickTime and some AVI).

MoViz is not natively QuickTime, it uses the AVI wrappers and filters for QuickTime and AVIs. This means that not all QuickTime codecs can be used, only the ones that are supported within DirectX wrappers and filters.

Note: Throughout this plug-in documentation, media file and media stream is referred to as media and may be used interchangeably unless stated otherwise.

Note: This plug-in is located in: Plugins -> Container plug-ins -> Texture

Warning: Always make sure to install the required codecs for used media files. Missing codecs can lead to engine crashes.

MoViz Properties

  • Clip URI: Click the Browse button ( images/download/thumbnails/114312562/ma_elip.png ) to load clips from the file system (or enter the location directly). It takes the form of a valid URI (e.g. http://... or mms://...). If the parameter is changed and the plug-in is already started it stops the playback before loading a new clip. Changes are effective immediately.

    IMPORTANT! All video clips from the file system should be stored locally on the D:\ drive of the machine that is used to play out the graphics. Remember to save the clip locally on the client machines with preview (e.g. Viz Trio) and use the same D:\ drive so that the clip can be seen in preview.

  • Clip URI Stereo: Path to Clip that is loaded for the right eye camera in a stereo configuration with Stereo Mode = Right Eye. You can load clips from the file system by using the Browse button, or by typing the path location directly. It takes the form of a valid URI. (e.g. http://... or mms://...). If you change the parameter after starting the plug-in, it stops the playback before loading the new clip. Changes are effective immediately.

  • Autoplay: Sets the automatic start of the clip after it has loaded, to On or Off. Changes are effective immediately (Default is off).

  • Loop Clip: Sets looped playback to On or Off. If the clip position is at the clip out position or EOF it rewinds to the clip in position. Changes are effective for the next EOF, clip out position (Default is Off).

  • Sync to Video Counter: Enables or disables the use of the system retrace counter. If enabled, the clip is played back with the speed of Viz's internal retrace counter. This is the tick count of the SDI output. If disabled, the clip plays back at the speed of its own internal clock.

  • Clip Duration (ms): Shows the duration of the clip in milliseconds (read only). This parameter makes only sense with media that supports this kind of information.

  • Clip Position (ms): Gives the current position of the clip in milliseconds. When in pause mode this parameter may be changed to seek to the gives time. Do not change this parameter when not in pause mode. The position may be changed between Clip Position IN and Clip Position OUT. This parameter makes only sense with media that supports this kind of information. Changes are effective immediately.

  • Clip Position IN (ms): Gives the first frame where the clip should start in milliseconds. This parameter makes only sense with media that supports this kind of information. Changes are effective immediately.

  • Clip Position OUT (ms): Gives the last frame where the clip should stop in milliseconds. This parameter makes only sense with media that supports this kind of information. Changes are effective immediately.

  • Video Device Format: Selects a video format for rendering. Changes are effective at load time.

    • None: Does not render the video portion.

    • RGB24: Delivers the video portion to Viz Artist/Engine with the RGB24 format. This format uses eight bits per Red, Green and Blue component, hence the name RGB24.

    • ARGB32: Delivers the video portion to Viz Artist/Engine with the ARGB32 format. This format uses eight bits per Red, Green and Blue component and in addition eight bits for Alpha (8-bits * 4 components), hence the name ARGB32 indicating RGB with Alpha. This format is often referred to as RGBA.

  • Force Opaque: (ARGB32 only) Sets the alpha value to 100% opaque (if required) if the clip has an alpha channel. Changes are effective for each frame delivered.

  • Auto Scale Texture: Scales captured video according to underlying geometry when enabled.Changes are effective immediately but not for already delivered video.

    • Border Crop Width: Crops pixels on the horizontal sides of the video. Changes are effective immediately but not for already delivered video.

    • Border Crop Height: Crops pixels on the vertical sides of the video. Changes are effective immediately but not for already delivered video.

  • Audio Device/Format: Selects which audio device/format to use for rendering. Changes are effective immediately but not for already delivered audio. For performance reasons, None is the recommended setting.

    • None: Does not render the audio portion.

    • Default Device: Renders the audio portion using the default DirectShow renderer.

  • Status Loaded: Shows if the clip has loaded.

  • Status EOF: Shows if the clip is at EndOfFile. Status EOF allows user defined actions upon registering for change requests in a script. Whenever a change in the parameter StatusEof is happening and a Viz System Shared Memory (SHM) variable named MoViz[A,B]_eof exists, this variable is set to 1 when Status EOF is On, and to 0 when Status EOF is Off. The variable’s parameter A is the hexadecimal value of the scene ID in uppercase A-F range. The variable’s parameter B is the hexadecimal value of the Container ID in uppercase A-F range.

Note: Since Viz Engine 3.8.1, this is supported for MoViz Version 2.20.0 onwards.

  • Status Clip Width: Shows the video width.

  • Status Clip Height: Shows the video height.

  • Status Video: Shows if the clip has a usable video component.

  • Status Audio: Shows if the clip has a usable audio component.

  • Seek Timeout: Specifies the timeout for seeking to a position in the movie file. Higher values can prevent jump back to the expected position when clip playback takes longer to start then expected. However, the playback time may not be as exact.

  • Eject: Unloads the clip and destroy the graph. Changes are effective immediately.

  • Load: Loads the given clip and builds the graph. Changes are effective immediately.

  • Rewind: Rewinds the clip to the start, when supported. Changes are effective immediately.

  • Stop: Puts the graph in stop mode. Changes are effective immediately.

  • Play: Puts the graph in play mode (i.e. start playback). Changes are effective immediately.

  • Pause: Puts the graph in pause mode. Changes are effective immediately.

  • Play From Start: Rewinds the clip to the start before playback. Changes are effective immediately.

  • Clear: Clears the texture to opaque white.

    Note: Moviz handles videos with alpha, but the codecs in use must provide a valid ARGB32 stream and Containers you want visible should use the KEY Function, otherwise the alpha channel is blank, making the whole video totally transparent. See also Advanced Issues with Video Codecs in the Viz Artist User Guide.

See Also