Introduction

The Drastic MediaCmd SDK is the mechanism by which all the elements of Drastic's DDRs communicate with one and other. This includes:

* Controlling VVW DDR Servers, QuickClip locally, and QuickClip with network option remotely

* Controlling 9 pin serial VTRs and Servers via Sony, Odetics or VDCP protocol

* Receiving commands from 9 pin serial controller via Sony, Odetics or VDCP protocol

* Receiving commands from Drastic GUIs, servers and controllers

* Building HTML/Ajax status and control pages

MediaCmd is the commincation method used within Drastic's DDR products. Any operation you see in a Drastic interface is available to your application through MediaCmd.

Overview

MediaCmd is a simple structure that supports a small, well defined set of commands for communicating transport, status and setup information between components in Drastic's DDR software. There are a number of fields in the stucture, but the important fields are:

* ctCmd – the primary command of this packet (Play, Pause, Stop, Record, etc)

* lSpeed – the transport speed for any play commands (integer where 65520 = normal forward play)

* dwPosition – the frame position for any play, pause or record commands

* dwStart – the starting frame for any play or record commands (inclusive)

* dwEnd – the ending frame for any play or record commands (exclusive)

* arbID – clip name, file name or other string/binary data for the command

* cfFlags – denotes which fields above are valid and their meaning

With the standard initialization of the structure, you can quickly build commands in this structure by changing a few members and sending it. The primary motion commands are ctPlay, ctPause, ctStop, ctRecStop, ctRecord, ctEject and ctTransfer. To get the current state (position, speed, start and end, current clip), the command ctGetState will return a filled in MediaCmd. For setup and less common status (e.g. video input, audio rms level, genlock) there is ctGetValue and ctSetValue. This is documented in the Low Level Header Docs.

Hopefully, you will not have to deal with the MediaCmd structure directly. The SDK includes a series of simple commands that should provide 99% of what your application needs. These functions are simply wrappers that create and send MediaCmd structures. The source for all these functions is provided in the SDK under SRC\General\vvwIF.cpp in case you need to modify or create new commands. The commands have slightly different names depending on which interface you use, but have the same root name, such as: Play(), PlayFromTo(), Stop(), Pause(), Seek(), Record() and UpdateStatus(). Commands are also included for getting clip lists (GetNextClip()) and EDL elements from ::VTR_TC time code spaces (EDLResetToStart(), EDLGetEdit()). A selection of the most common settings are also included (SetVideoInput(), SetAudioInput(), SetVideoGenlock(), GetAudioPeakRMS(), etc). This interface is documented in the MediaCmd Documentation (previously called “VVW Interface Specification”).

Installation

To properly work with the MediaCmd SDK, you should have a copy of the QuickClip software installed on your development system. Even if you target application will only use a part of the QuickClip software, it should all be installed for the development phase. Before proceeding with the SDK you should familarize your self with QuickClip's operation and toolset. All the elements available within QuickClip are the same elements available to your application through the SDK.

Once you have QuickClip installed, you should install the MediaCmd SDK. This will install the headers, libraries and source needed to control QuickClip from your application.

Choosing An Access Method

The SDK access method you should use depends on what you you would like your application to do, what programming language you are using and how involved you would like to/need to get in the low level MediaCmd structures. No matter which method you choose, the MediaCmd structure packets are exactly the same. Here are the main access method, with their pros and cons:

ActiveX

Type: Microsoft ActiveX/COM access method

Pros: Easy to program, 1:1 relationship with QuickClip/XO interface.

Cons: Uses same config as QuickClip/XO. Requires a local copy of QuickClip.

Setup: Register VVW.DLL using RegSvr32.exe in the QuickClip installation directory.

Issues: Difficult to use when communicating via TCP/IP within the same machine. Can be overcome by using the default pipe communication system, but this requires changes for remote network control.

Direct Link

Type: Direct link to VVW.DLL

Pros: No ActiveX layer, code compatible with Linux, Irix, Mac OS-X.

Cons: Uses default config from QuickClip/XO, application must be run in QuickClip directory. Requires a local copy of QuickClip.

Setup: Link to vvw.lib, include vvw.h. Copy application into the QuickClip directory before running

Issues: Needs access to VVW.dll and all its support DLLs/D1Xs. Still needs to be setup by LocalConfig.exe or QuickClip/XO

Network DLL

Type: Direct line to vvwNet2.dll

Pros: Consistant interface between local/remote and various OSs. Does not require a local copy of QuickClip.

Cons: Requires vvwNet2.dll and support dlls

Setup: Link to vvwNet2.lib, include vvwNet2.h. Copy dll set from SDK\bin directory with your application

Issues: Use the netOpenLocal function to avoid QuickClip configuration issues. Requires a few dlls to be added to you application installations. Does not run the client software automatically, so you application may need to start it, depending on what your application is doing.

Network Direct

Type: Direct compile of network sources in your app or your dll.

Pros: No extra dlls. Easy to customize and modify. Lots of comands already written.

Cons: You app needs to handle setup and may need to run QuickClip.exe/VVWServer.exe/QCRun.exe.

Setup: Copy source files from vvwNet2 into you project, modify and compile

Issues: Does not run the client software automatically, so you application may need to start it, depending on what your application is doing.

Manual

Type: Use the structures and defines to write your own communication and control layer.

Pros: This is required if you are using an unsupported development platform like PHP.

Cons: Everything has to be built and tested from the ground up.

Setup: None.

Issues: Unless you absolutely have to, this method is not recommended.

SDK Structure

The location of the SDK directories will depend on the location you choose during the installation, but the directories within there will always be the same:

* \BIN – Copies of the minimum dll set from a QuickClip installation.

* \LIB – Libraries required to link the vvwNet2.dll, examples and your application

* \INC – Header files required to compile vvwNet2.dll, examples and your application

* \Src\vwwNet2 – The source to our vvwNet2.dll from QuickClip

* \Src\General – Useful source files that do not compile into examples directly. The most important would be vvwIF.cpp that is the code behind the SDK functions described below.

* \Sample – Broken down into sub directories based on access type

o \ActiveX – Examples that use the ActiveX control

o \Direct – Examples that link directly to DLLs

o \Java – Java based examples

o \HTTP – Ajax based examples (must use QuickClip HTTP server to run)

Main Documentation

*** PDF version of the MediaCmd Documentation

http://www.drastictech.com/manuals/VVW%20Interface%20Specification.pdf

*** Online version of the MediaCmd Documentation

http://www.drastictech.com/manuals/VVW%20Interface%20Specification.html

Low Level Header Documentation

*** Windows CHM help file version of the MediaCmd headers

http://www.drastictech.com/manuals/MediaCmd.chm

*** Online version of the MediaCmd headers

http://www.drastictech.com/manuals/mediacmd/

HTTP XML AJAX Documentation

*** Wikki area for HTTP XML MediaCmd

http://www.drasticpreview.org/wakka.php?wakka=DrasticHttpCommands&v=d9c

Components

The VVW interfaces are designed to allow VWW customers, OEMs and Drastic component OEMS to create custom control solutions in the simplest manner possible. We have attempted to create a series of similar interfaces across as many development environments as possible.

Controllable Components:

VVW - Contains all other components

vvwXXX - Hardware driver components for VVW-1000 through 7000 series DDRs

vvvNET - Direct network sender to VVW or user component (TCP/IP)

vvwDSync - House clock/SMPTE LTC, Local GPI Control

Controlling Components:

vvwCTL - RS-422/Network Interpreter for VTR/DDR Emulation

vvwNET - Direct network interpreter from VVW or user component (TCP/IP)

vvwHTTPD - XML and Web based network control

Interface Types:

ActiveX - MediaCmdX - Visual C++, Visual Basic, Borland C/Delphi, etc

Java (direct) - MediaCmdInterface - Visual J++, Sun Java, Symantec

Unix - mediacmd.so - GNU (Linux/BSD)

Unix - mediacmd.c - Shrouded Source

HTML - mediacmd.xml - XML I/O (w HTML components)

XML - mediacmd.xml - XML direct network connection

Do not use this interface type (being removed):

VVW - VVW.lib/VVW.h - Direct DLL Control

References

MediaCmd.h - Internal media cmd structures on which this interface is based.

VVWIF.h - VVW Direct Access (includes previous access method as well)

VVWX.tlb - MediaCmdX type library

MediaCmd.xml - XML command set mirroring MediaCmd.h

CntrlVVW_VB1 - Simple control from Visual Basic

CntrlVVW_MFC1 - Simple control from Visual C++ with MFC

CntrlVVW_Java - Simple control from Visual J++/WFC

CntrlVVW_Cmd - Command line controller using the DLL methods

VTRControl - Test app for VTR control

LocalConfig - VVW Setup

X-extdev.prm - VTR plug in for Adobe Premiere

(QuickClipProSW - Coming soon)

Interface

The following is assumed:

Language/Platform	Name	Notes
ActiveX VB	Vbx	ActiveX Control
ActiveX C++	Pcx	Pointer to ActiveX Control
Java Instantiation	Mci	MediaCmd Interface – Network Only
DLL		No prefix
Unix XML		No prefix – Network Only Via HTTP or Direct

All pointers for ActiveX C++, DLL and Unix must be valid and correctly sized
Any BSTR returns are freed by the caller using our utility function FreeString()
Any char * returns are freed by the caller using our utility function FreeString()
For Unix the type VVWBOOL is defined as typedef long VVWBOOL
For ActiveX/Dll, BOOL is the Windows.h BOOL definition
szClipName has a maximum of 8 alpha numeric characters as per the Louth and Odetics specifications
szFileName is DOS/Windows formatted in one of two forms
X:\Some Path\On The Drive\Media Files Name.ext
\\VVWSERVER\X\ Some Path\On The Drive\Media Files Name.ext
Not all channels are equally capable. Check functions before assuming they will work as they do on other VVW systems or channels. Each VVW System and associated channel will be consistent. Please check you server documentation for its specific features.

Nomenclature:

szClipName. Sz8CharClipName, etc

Any character area identified by the words clip and name refers to a Louth/Odetics style clip name. These names may be up to 8 characters in length plus a NULL terminating character. This means they should be allocated in the following manner:

Char szClipName[9] = “”; // Include unused 1 char safety

Char pClipName = new char[9];

Char szpClipName = malloc(9);

SzFileName, sz260FileName, etc

Any character area identified by the words file and name refers to a win32 style drive/path/file/ext name. These areas may be up to 260 characters in length plus a terminating NULL character. This means they should be allocated in the following manner:

Char szClipName[261] = “”; // Include unused 1 char safety

Char pClipName = new char[261];

Char szpClipName = malloc(261);

Time code strings

Time code strings may be as small as one character and have a maximum length of 14 characters plus a terminating NULL. This means they should be allocated in the following manner:

Char szClipName[15] = “”; // Include unused 1 char safety

Char pClipName = new char[15];

Char szpClipName = malloc(15);

JAVA

To use the Java VVW interface begin by importing the VVW interface package. The Java VVW Interface is neatly packaged in the VVWInterface.zip file provided.

import drastic.mCmdIF.*;

You must ensure that the VVWInterface.zip file is accessible by the JVM. If the VVWInterface.zip file is not in the same file structure as your current project you must tell the JVM where to look for it by setting your classpath to it’s current location.

After you have successfully imported the VVW interface package begin by instantiating a new instance of the MediaCmdIF class.

MediaCmdIF mci = new MediaCmdIF();

The newly instantiated MediaCmdIF object will have access to all VVW interface methods. Some MediaCmdIF methods require the user to instantiate a new object of the method’s parameter type.

MediaCmdIF.ClipInfo clipData = new MediaCmdIF.ClipInfo(clipName)

mci.GetClipInfo(clipData);

long lEnd = clipInfo.lEnd;

This allows the VVWInterface to return multiple values in the defined class structure.

Note: Applets using the VVW Interface must have an archive tag in the applet’s HTML file specifying the location of the VVWInterface.zip file.

Channel Control

EnableChannels

ActiveX VB	vbx.EnableChannels (lInternal0_31 As Long, lInternal32_63 As Long, lExternal64_95 As Long, lExternal96_127 As Long, lNetwork128_159 As Long, lNetwork160_192 As Long) As Long
ActiveX C++	long pcx->EnableChannels (long lInternal0_31, long lInternal32_63, long lExternal64_95, long lExternal96_127, long lNetwork128_159, long lNetwork160_192)
Java	Not Available
Dll	long vvw EnableChannels (long lInternal0_31, long lInternal32_63, long lExternal64_95, long lExternal96_127, long lNetwork128_159, long lNetwork160_192)
Unix	Not Available
XML	Not Available

Enable or disable channels based on the bit array supplied. VVW can contain up to 256 channels per access point. Channels 193-255 are disabled by default. The remaining channels may be enabled (if the corresponding bit is set to 1) or disabled (if the corresponding bit is set to 0) with this call. The first 64 channels (0 through 63) are reserved for internal ddr channels. Then next 64 channels (64 through 127) are reserved for VTR or DDR devices controlled via serial, Odetics or Louth protocol. The remaining channels are for controlling other devices through the network. Please note that a network channel controls all the channels on the network server box, so disabling one network connection may disable more than one channel. Always call GetMaxChannels() after setting the bits to make sure all the channels you expect exist actually exist. This should be the first call made to the activex component.

GetMaxChannels

ActiveX VB	vbx.GetMaxChannels () As Long
ActiveX C++	long pcx->GetMaxChannels ()
Java	long mci.GetMaxChannels ()
Dll	long vvwGetMaxChannels (long lChannel)
Unix	long GetMaxChannels ()
XML	Not implemented

Returns the maximum number of channels available for control. Channels start at 0 and end at max channels – 1. This return is one greater than the largest value available for SetCurChannel(), GetCurChannel() and the lChannel parameter for the DLL interface.

SetCurChannel

ActiveX VB	vbx.GetMaxChannels (lChannel As Long) As Long
ActiveX C++	long pcx->GetMaxChannels (long lChannel)
Java	long mci.SetMaxChannels (long lChannel)
Dll	Not implemented
Unix	long SetCurChannel (lChannel As long)
XML	Use 'setchannel=

Sets the channel to which all subsequent commands will be sent. This command does not exist in the Dll interface as the channel is sent on a per command basis.

Returns 0 or an error code

GetCurChannel

ActiveX VB	vbx.GetCurChannels () As Long
ActiveX C++	long pcx->GetCurChannels ()
Java	long mci.GetCurChannels ()
Dll	Not implemented
Unix	long GetCurChannel ()
XML	Not required

Get channel currently under control. This value will be between 0 and GetMaxChannels – 1.

GetCurChannelName

ActiveX VB	vbx.GetCurChannelName () As String
ActiveX C++	BSTR pcx->GetCurChannelName ()
Java	String mci.GetCurChannelName ()
Dll	Long vvwGetChannelName(long lChannel, char * szChanName)
Unix	long GetCurChannelName (char * szChanName)
XML	Not required

Get the name of the current channel. For unix and dll access, pass a null to get the channel name size, then pass in a pointer that points to a memory size of at least that many bytes (ANSI characters only).

GetCurChannelType

ActiveX VB	vbx.GetCurChannelType () As Long
ActiveX C++	long pcx->GetCurChannelType ()
Java	long mci.GetCurChannelType ()
Dll	long vvwGetChannelType (long lChannel)
Unix	long GetCurChannelType ()
XML	Not supported

Returns the basic type of the channel (VTR, Internal, User, House)

VVW_CHANTYPE_HOUSE 0x1 1

VVW_CHANTYPE_INTERNAL 0x2 2

VVW_CHANTYPE_VTR_DDR 0x4 4

VVW_CHANTYPE_UNKNOWN 0xFFFFFFFF -1

ShowConfigDialog

ActiveX VB	vbx.ShowConfigDialog (hWnd as Long) As Long
ActiveX C++	long pcx->ShowConfigDialog (long hWnd)
Java	Not Available
Dll	long vvw ShowConfigDialog (long hWnd)
Unix	Not Available
XML	Not Available

Show the configuration dialog box for the current channel. If the channel does not have a configuration dialog, this function will return an error. It is not available in Java or unix as the dialog only shows up on the local machine, and cannot be seem through the network.

Network Specific

Connect

ActiveX VB	Not implemented
ActiveX C++	Not implemented
Java	boolean mci.Connect(String szServerAddress, int lPort)
Dll	Not implemented
Unix	Long Connect (char * szServerAddress, long lPort)
XML	Not required

Connect to a server specified in szServerName (either the IP address or network name) using a specific port (default 1234). For ActiveX and Dll access, please setup a persistent network connection in the VVW configuation utility.

Returns true if the connect was successful, else it returns false.

Disconnect

ActiveX VB	Not implemented
ActiveX C++	Not implemented
Java	boolean mci.Disconnect()
Dll	Not implemented
Unix	Long Disconnect()
XML	Not required

Disconnect from a previously connected server. For ActiveX and Dll access, please setup a persistent network connection in the VVW configuation utility.

Transport Operations

Play

ActiveX VB	vbx.Play () As Long
ActiveX C++	long pcx->Play ()
Java	long mci.Play ()
Dll	long vvwPlay (long lChannel)
Unix	long Play ()
XML	http://localhost/VVWXMLMediaCmd?Play

Play at normal speed.

Returns 0 if successful, else an error code.

PlayAtSpeed

ActiveX VB	vbx.PlayAtSpeed (lVVWSpeed As Long) As Long
ActiveX C++	long pcx->PlayAtSpeed (long lVVWSpeed)
Java	long mci.PlayAtSpeed (long lVVWSpeed)
Dll	long vvwPlayAtSpeed (long lChannel, long lVVWSpeed)
Unix	long PlayAtSpeed(long lVVWSpeed)
XML	http://localhost/VVWXMLMediaCmd?Play &speed=lVVWSpeed

Play at a particular VVW speed. VVW speeds use a base play speed of 65520. This means that play = 65520, reverse play = -65520, four times play = 262080, half play speed = 32760. Percentage play speeds may be converted to VVW speeds using the PercentageToVVWSpeed() function. For Speed calculations please see GetSpeed() below.

Returns 0 if successful, else an error code.

PlayFromTo

ActiveX VB	vbx.PlayFromTo (lFrom As Long, lTo As Long, fDeferred As Boolean) As Long
ActiveX C++	long pcx->PlayFromTo (long lFrom, long lTo, BOOL fDeferred)
Java	long mci.PlayFromTo (long lFrom, long lTo, boolean fDeferred)
Dll	long vvwPlayFromTo (long lChannel, long lFrom, BOOL lTo, bool fDeferred)
Unix	long PlayFromTo (long lFrom, long lTo, VVWBOOL fDeferred)
XML	http://localhost/VVWXMLMediaCmd?Play&start=lFrom &end=lTo

Play from a frame to another frame. As with editing systems, the ‘from’ point is included and will be displayed but the to point is NOT included and will not be displayed. This means that the last frame displayed will be lFrom – 1. The deferred flag allows

PlayFromTos to be stacked so that they will play back to back. The deferred flag in the status return should be false before another deferred command is added.

Returns 0 if successful, else an error code.

LoadClip

ActiveX VB	vbx.LoadClip (szClipName As String, lStartFrame As Long) As Long
ActiveX C++	long pcx-> LoadClip (BSTR szClipName, long lStartFrame)
Java	long mci. LoadClip (String szClipName, long lStartFrame)
Dll	long vvwLoadClip (long lChannel, char * szClipName, long lStartFrame)
Unix	long LoadClip (char * szClipName, long lStartFrame)
XML	http://localhost/VVWXMLMediaCmd?Pause &ClipID=szClipname

Clip Mode Only. Load a clip into the channel and display the lStartFrame.

Returns 0 if successful, else an error code.

PlayClip

ActiveX VB	vbx.PlayClip (szClipName As String, fDeferred As Boolean) As Long
ActiveX C++	long pcx->PlayClip (BSTR szClipName, BOOL fDeferred)
Java	long mci.PlayClip (String szClipName, boolean fDeferred)
Dll	long vvwPlayClip (long lChannel, char * szClipName, BOOL fDeferred)
Unix	long PlayClip(char * szClipName, VVWBOOL fDeferred)
XML	http://localhost/VVWXMLMediaCmd?Play &ClipID=szClipname&Flags=Deferred

Clip Mode Only. Play the entire clip specified by clip name. If the deferred flag is true, clip playback will only occur once the currently playing clip has finished. If there is no currently playing clip, playback will occur immediately.

Returns 0 if successful, else an error code.

PlayClipFromTo

ActiveX VB	vbx.PlayClipFromTo (szClipName As String, lFrom AS Long, lTo As Long, fDeferred As Boolean) As Long
ActiveX C++	long pcx->PlayClipFromTo (BSTR szClipName, long lFrom, long lTo, BOOL fDeferred)
Java	long mci.PlayClipFromTo (String szClipName, long lFrom, long lTo, boolean fDeferred)
Dll	long vvwPlayClipFromTo (long lChannel, char * szClipName, long lFrom, long lTo, BOOL fDeferred)
Unix	long PlayClipFromTo (char * szClipName, long lFrom, long lTo, VVWBOOL fDeferred)
XML	http://localhost/VVWXMLMediaCmd?Play&start=lFrom &end=lTo&ClipID=szClipname

Clip Mode Only. Play the specified portion of the clip specified by clip name. If the deferred flag is true, clip playback will only occur once the currently playing clip has finished. If there is no clip currently playing, playback will occur immediately.

Returns 0 if successful, else an error code.

FastFoward

ActiveX VB	vbx.FastForward () As Long
ActiveX C++	long pcx-> FastForward ()
Java	long mci. FastForward ()
Dll	long vvwFastForward (long lChannel)
Unix	long FastForward ()
XML	http://localhost/VVWXMLMediaCmd?Play &speed=655200

Set the channel into its fastest possible forward motion state.

Returns 0 if successful, else an error code.

FastRewind

ActiveX VB	vbx.FastRewind () As Long
ActiveX C++	long pcx-> FastRewind ()
Java	long mci. FastRewind ()
Dll	long vvwFastRewind (long lChannel)
Unix	long FastRewind ()
XML	http://localhost/VVWXMLMediaCmd?Play &speed=-655200

Set the channel into its fastest possible reverse motion state.

Returns 0 if successful, else an error code.

Pause

ActiveX VB	vbx.Pause () As Long
ActiveX C++	long pcx-> Pause ()
Java	long mci. Pause ()
Dll	long vvwPause (long lChannel)
Unix	long Pause ()
XML	http://localhost/VVWXMLMediaCmd?Pause

Stop playback and display the current frame.

Returns 0 if successful, else an error code.

Seek

ActiveX VB	vbx.Seek (lFrame As Long) As Long
ActiveX C++	long pcx-> Seek (long lFrame)
Java	long mci. Seek (long lFrame)
Dll	long vvwSeek (long lChannel, long lFrame)
Unix	long Seek (long lFrame)
XML	http://localhost/VVWXMLMediaCmd?Pause &position=lFrame

Seek to a particular frame and display it to the user. This call will return before the seek is complete. Once the Position return in the status reaches the lFrame, the seek is complete.

Returns 0 if successful, else an error code.

SeekRelative

ActiveX VB	vbx.SeekRelative (lFrameOffset As Long) As Long
ActiveX C++	long pcx-> SeekRelative (long lFrameOffset)
Java	long mci. SeekRelative (long lFrameOffset)
Dll	long vvwSeekRelative (long lChannel, long lFrameOffset)
Unix	long SeekRelative (long lFrameOffset)
XML	http://localhost/VVWXMLMediaCmd?Pause &position=lFrameOffset

Seek a certain number of frames from the current position. Positive offsets imply forward direction, negative offset imply reverse.

Stop

ActiveX VB	vbx.Stop () As Long
ActiveX C++	long pcx-> Stop ()
Java	long mci. Stop ()
Dll	long vvwStop (long lChannel)
Unix	long Stop ()
XML	http://localhost/VVWXMLMediaCmd?Stop

Stop the output of the controlled channel and display the input video (not supported on all devices). On unsupported devices stop will be the same as a pause.

Returns 0 if successful, else an error code.

Record

ActiveX VB	vbx.Record () As Long
ActiveX C++	long pcx-> Record ()
Java	long mci. Record ()
Dll	long vvwRecord (long lChannel)
Unix	long Record ()
XML	http://localhost/VVWXMLMediaCmd?Record

Start the channel recording. In clip mode a default clip name will be used with a duration set to infinity. The record will stop on any transport command or at the point that the disk is full.

Returns 0 if successful, else an error code.

RecordFromTo

ActiveX VB	vbx.RecordFromTo (lFrom As Long, lTo As Long) As Long
ActiveX C++	long pcx-> RecordFromTo (long lFrom, long lTo)
Java	long mci. RecordFromTo (long lFrom, long lTo)
Dll	long vwwRecordFromTo (long lChannel, long lFrom, long lTo)
Unix	long RecordFromTo (long lFrom, long lTo)
XML	http://localhost/VVWXMLMediaCmd?Record &start=lStart&end=lEnd

Record from a frame value to a frame value. As with editing systems, the ‘from’ point is included and will be recorded but the to point is NOT included and will not be recorded. This means that the last frame recorded will be lFrom – 1.

Returns 0 if successful, else an error code.

RecordStop (prepare record)

ActiveX VB	Vbx.RecordStop (szClipName As String, lDuration As Long) As Long
ActiveX C++	Long pcx-> RecordStop (BSTR szClipName, long lDuration)
Java	Long mci. RecordStop (String szClipName, long lDuration)
Dll	Long vvwRecordStop (long lChannel, char * szClipName, long lDuration)
Unix	Long RecordStop (char * szClipName, long lDuration)
XML	http://localhost/VVWXMLMediaCmd?RecStop

Clip Mode Only. Set the clip name and length of time to record in frames. The record will not actually start until Record() is called. If the lDuration is set to –1 the record will continue until Stop() is called or the channel runs out of space.

Returns 0 if successful, else an error code.

SetRecordPresets

ActiveX VB	vbx.SetRecordPresets (lVidEdit As Long, lAudEdit As Long lInfEdit As Long) As Long
ActiveX C++	long pcx-> SetRecordPresets (long lVidEdit, long lAudEdit, long lInfEdit)
Java	long mci. SetRecordPresets (long lVidEdit, long lAudEdit, long lInfEdit)
Dll	long vvwSetRecordPresets (long lVidEdit, long lAudEdit, long lInfEdit)
Unix	long SetRecordPresets (long lVidEdit, long lAudEdit, long lInfEdit)
XML	http://localhost/VVWXMLMediaCmd?Record &videochannels=lVidEdit&audiochannels=lAudEdit &infochannels=lInfEdit

Set the channels to record. Using –1 values implies that the Preset should be set to all available channels. Record Presets will remain set until the user changes them.

Returns 0 if successful, else an error code.

Eject

ActiveX VB	vbx.Eject () As Long
ActiveX C++	long pcx-> Eject ()
Java	long mci. Eject ()
Dll	long vvwEject (long lChannel)
Unix	long Eject ()
XML	http://localhost/VVWXMLMediaCmd?Eject

Eject the current media if it is removable. Normally only used with VTRs.

Returns 0 if successful, else an error code.

Special Commands

Please note: Not all the following commands are supported on all channels. Special restrictions may apply

Transfer

ActiveX VB	vbx.Transfer (lTargetChannel As Long, lPosition As Long, lStart As Long, lEnd As Long, lVidEdit As Long, lAudEdit As Long, lInfEdit As Long, szClipName As String, fToTape As Boolean) As Long
ActiveX C++	long pcx-> Transfer (long lTargetChannel, long lPosition, long lStart, long lEnd, long lVidEdit, long lAudEdit, long lInfEdit, BOOL fToTape)
Java	long mci. Transfer (long lTargetChannel, long lPosition, long lStart, long lEnd, long lVidEdit, long lAudEdit, long lInfEdit, Boolean fToTape)
Dll	long vvwTransfer (long lChannel, long lTargetChannel, long lPosition, long lStart, long lEnd, long lVidEdit, long lAudEdit, long lInfEdit, BOOL fToTape)
Unix	long Transfer (long lTargetChannel, long lPosition, long lStart, long lEnd, long lVidEdit, long lAudEdit, long lInfEdit, VVWBOOL fToTape)
XML	http://localhost/VVWXMLMediaCmd?Transfer &channel=lTargetChannel&position=lPosition &start=lStart&end=lEnd&videochannels=lVidEdit &audiochannels=lAudEdit&infochannels=lInfEdit &Flags=Invert

Transfer media from one channel to another. Only supported by VTR channels. Currently only implemented for VTR to internal channels or internal channels to VTR channels. To record media from a VTR, the fToTape should be false, to record media onto a VTR the fToTape should be true. The start and end point are from the playback device. The edit will occur at the current timecode location on the recorder.

Returns 0 if successful, else an error code.

Status Operation

UpdateStatus

ActiveX VB	vbx.UpdateStatus () As Long
ActiveX C++	long pcx-> UpdateStatus ()
Java	long mci. UpdateStatus ()
Dll	long vvwUpdateStatus (long lChannel)
Unix	long UpdateStatus ()
XML	http://localhost/VVWXMLGetStatus?

Retrieve the current status from the controlled device. The status is automatically updated by the interface, but this call ensures that the status is current when you are checking it.

Returns 0 if successful, else an error code.

VVWXMLGetStatus returns XML with a MediaCmd root element, for example:

<?xml version="1.0" ?>

- <MediaCmd>

- <!-- Drastic MEDIACMD xml structure version 1,0

-->

<Cmd Value="1" UseClipID="1">Pause</Cmd>

</MediaCmd>

GetState

ActiveX VB	vbx.GetState () As Long
ActiveX C++	long pcx-> GetState ()
Java	long mci. GetState ()
Dll	long vvwGetState (long lChannel)
Unix	long GetState ()
XML	http://localhost/VVWXMLGetStatus?

Returns the current state

ctStop 0 // Stop all action
ctPause 1 // Pause, Seek
ctPlay 2 // Play at specified speed (includes pause)
ctRecord 3 // Record at specified speed
ctRecStop 4 // Stop ready for recording
ctEject 5 // Eject the current media
ctError 17 // An error has occurred
ctAbort 19 // Abort any queued commands

XML: See <MediaCmd> root element, <Cmd> sub-element (value)

GetFlags

ActiveX VB	vbx. GetFlags () As Long
ActiveX C++	long pcx-> GetFlags ()
Java	long mci. GetFlags ()
Dll	long vvwGetFlags (long lChannel)
Unix	long GetFlags ()
XML	Not required

Returns the current flags

cfDeferred = 1, // 0x00000001 This is a delayed
cfOverideDeferred = 1 << 30, // 0x40000000 Overide all previous deferred commands
cfTimeMs = 1 << 1, // 0x00000002 Use Millisecond time for delayed time, not fields
cfTimeTarget = 1 << 2, // 0x00000004 Delayed time is offset from current time code
cfTimeHouseClock = 1 << 3, // 0x00000008 Delayed time is based on absolute (real) time
cfUseSpeed = 1 << 4, // 0x00000010 Set the new speed
cfUsePresets = 1 << 5, // 0x00000020 Use video and audio edit presets
cfUsePosition = 1 << 6, // 0x00000040 Use the position setting
cfUsePositionOffset = 1 << 7, // 0x00000080 Position is an offset
cfUseStart = 1 << 8, // 0x00000100 Start a new timecode
cfUseStartOffset = 1 << 9, // 0x00000200 Start is an offset from current tc
cfUseEnd = 1 << 10, // 0x00000400 End command as specified
cfUseEndOffset = 1 << 11, // 0x00000800 End is and offset from current tc
cfUseAllIDs = 1 << 12, // 0x00001000 Use all clip IDs
cfUseClipID = 1 << 13, // 0x00002000 Use new clip ID, otherwise use last or none
cfNoClipFiles = 1 << 14, // 0x00004000 Use new clip ID, otherwise use last or none
cfNoTCSpaces = 1 << 15, // 0x00008000 Use new clip ID, otherwise use last or none
cfUseCmdAlt = 1 << 16, // 0x00010000 Use the dwCmdAlt
cfIsShuttle = 1 << 17, // 0x00020000 Use speed in play for shuttle
cfFields = 1 << 20, // 0x00100000 Position, start and end are fields, not frames
cfRipple = 1 << 21, // 0x00200000 Ripple for insert or delete
cfLoop = 1 << 22, // 0x00400000 Loop the clip or in out
cfTrigger = 1 << 23, // 0x00800000 Trigger using dsync class
cfPreview = 1 << 24, // 0x01000000 Preview set (EE, non rt play)
cfInvert = 1 << 28, // 0x10000000 Invert a transfer
cfTest = 1 << 29, // 0x20000000 See if the command exists
cfNoReturn = 1 << 31, // 0x80000000 No return mediacmd is required

GetSpeed

ActiveX VB	vbx. GetSpeed () As Long
ActiveX C++	long pcx-> GetSpeed ()
Java	long mci. GetSpeed ()
Dll	long vvwGetSpeed (long lChannel)
Unix	long GetSpeed ()
XML	http://localhost/VVWXMLGetStatus?

Returns the current VVW speed if the cfUseSpeed flag is set, otherwise pause or full play speed. VVW speeds are based on 65520 as the play speed. To translate to decimal number where 1.0 represents play, use the following formula:

D1Speed = ((double)VVWSpeed / 65520.0)

For percentages, where 100.0 represents play speed, use the following formula:

Dpercent = (((double)VVWSpeed * 100.0) / 65520.0)

= ((double)VVWSpeed / 655.2)

XML: See <MediaCmd> root element, <Speed> sub-element

Typical VVW speeds (note speeds are linear):

Pause	0%	0
Play	100%	65520
Half Play	50%	32760
Reverse Play	-100%	-65520
Reverse Double Play	-200%	131040
10 Time Forward Play	1000%	655200
Max Forward Play	90000%	5896800
Max Reverse Play	-90000%	-5896800

GetPosition

ActiveX VB	vbx. GetPosition () As Long
ActiveX C++	long pcx-> GetPosition ()
Java	long mci. GetPosition ()
Dll	long vvwGetPosition (long lChannel)
Unix	long GetPosition ()
XML	http://localhost/VVWXMLGetStatus?

Returns the current position if the cfUsePosition flag is set, otherwise invalid.

XML: See <MediaCmd> root element, <Position> sub-element (value)

GetLastMs

ActiveX VB	vbx. GetLastMs () As Long
ActiveX C++	long pcx-> GetLastMs ()
Java	long mci. GetLastMs ()
Dll	long vvwGetLastMs (long lChannel)
Unix	long GetLastMs ()
XML	http://localhost/VVWXMLGetStatus?

Returns the millisecond time the last status occurred (time of the last vertical blank).

XML: See <MediaCmd> root element, <CmdAlt> sub-element

GetStart

ActiveX VB	vbx. GetStart () As Long
ActiveX C++	long pcx-> GetStart ()
Java	long mci. GetStart ()
Dll	long vvwGetStart (long lChannel)
Unix	long GetStart ()
XML	http://localhost/VVWXMLGetStatus?

Returns the current start or in point if the cfUseStart flag is set.

XML: See <MediaCmd> root element, <Start> sub-element

GetEnd

ActiveX VB	vbx. GetEnd () As Long
ActiveX C++	long pcx-> GetEnd ()
Java	long mci. GetEnd ()
Dll	long vvwGetEnd (long lChannel)
Unix	long GetEnd ()
XML	http://localhost/VVWXMLGetStatus?

Return the current end point or out point if cfUseEnd is set.

XML: See <MediaCmd> root element, <End> sub-element

GetClipName

ActiveX VB	vbx. GetClipName () As String
ActiveX C++	BSTR pcx-> GetClipName ()
Java	String mci. GetClipName ()
Dll	long vvwGetClipName (long lChannel, char * sz8CharClipName)
Unix	Char * GetClipName ()
XML	http://localhost/VVWXMLGetStatus?

Only supported in clip Mode. Returns the current clip name, if any. For dll access, the memory must be at least 9 bytes long (8 character bytes + NULL) and is always ANSI.

XML: See <MediaCmd> root element, <CmdID> sub-element

GetFileName

ActiveX VB	Vbx. GetFileName () As String
ActiveX C++	BSTR pcx-> GetFileName ()
Java	String mci. GetFileName ()
Dll	Long GetFileName (long lChannel, char * sz260CharFileName)
Unix	Char * GetFileName ()
XML	Not supported

Returns the current file name, if any. For dll access, the memory must be at lease 261 bytes long (260 bytes max path + NULL) and is always ANSI.

GetCurTC

ActiveX VB	Vbx. GetCurTC () As String
ActiveX C++	BSTR pcx-> GetCurTC ()
Java	String mci. GetCurTC ()
Dll	Long GetCurTC (long lChannel, char * sz14ByteTC)
Unix	Char * GetCurTC ()
XML	http://localhost/VVWXMLGetStatus?

Returns the current time code as a string (e.g. “00:01:00:00”). For dll access, the memory must always be at least 15 bytes long (14 byte time code plus id + NULL) and is always ANSI.

XML: See <MediaCmd> root element, <Positon> sub-element (text)

GetCurState

ActiveX VB	Vbx. GetCurState () As String
ActiveX C++	BSTR pcx-> GetCurState ()
Java	String mci. GetCurState ()
Dll	Long GetCurState (long lChannel, char * sz14ByteState)
Unix	Char * GetCurState ()
XML	http://localhost/VVWXMLGetStatus?

Returns the current state as a string (e.g. “Play”). For dll access, the memory must always be at least 15 bytes long (14 byte state + NULL) and is always ANSI.

XML: See <MediaCmd> root element, <Cmd> sub-element (text)

Media Operations

Clip Mode Operations

GetNextClip

ActiveX VB	Vbx. GetNextClip (szLastClip As String) As String
ActiveX C++	BSTR pcx-> GetNextClip (BSTR szLastClip)
Java	String mci. GetNextClip (String szLastClip)
Dll	Char * vvwGetNextClip (long lChannel, char * sz8CharLastClipCurClip)
Unix	Char * GetNextClip (char * sz8CharLastClipCurClip)
XML	http://localhost/VVWXMLNextClip?

Clip Mode Only. Returns the next clip identifier. To get the first clip, szLastClip should be an empty string. Once the last clip available has been returned, GetNextClip will return an error or NULL for unix/dll access. Please note: For unix/dll access, the sz8CharLastClipCurClip memory area is used for the new clip. The previous clip name is therefore lost and the memory is not allocated by the vvw.

Returns 0 if successful, else an error code.

VVWXMLNextClip returns XML with a ClipInfo root element, for example:

<?xml version="1.0" ?>

- <ClipInfo>

- <!-- Drastic ClipInfo xml structure version 1,0

-->

</ClipInfo>

GetClipInfo

ActiveX VB	Vbx. GetClipInfo (szClipName As String, ByRef lStart As Long, ByRef lEnd As Long, ByRef lVidEdit As Long, ByRef lAudEdit As Long, ByRef lInfEdit As Long, szFileName As String) As Long
ActiveX C++	Long pcx-> GetClipInfo (BSTR szLastClip, long * lStart, long * lEnd, long * lVidEdit, long * lAudEdit, long * lInfEdit, BSTR * szFileName)
Java	Long mci. GetClipInfo (mci.ClipInfo clipData)
Dll	Long vvwGetClipInfo (long lChannel, char * sz8CharClipName, long * lStart, long * lEnd, long * lVidEdit, long * lAudEdit, long * lInfEdit, char * sz260CharFileName)
Unix	Long GetClipInfo (char * sz8CharClipName, long * lStart, long * lEnd, long * lVidEdit, long * lAudEdit, long * lInfEdit, char * sz260CharFileName)
XML	http://localhost/VVWXMLNextClip?

Retuns the basic information from szClip. The information is located in lStart, lEnd, lVidEdit, lAudEdit and szFileName as the in point, out point, number of video channels, number of audio channels, and the file name respectively.

Returns 0 if successful, else an error code.

Java: This method requires the user to instantiate a new object of type ClipInfo. The sz8CharClipName, lStart, lEnd, lVidEdit, lAudEdit, lInfEdit, and sz260CharFileName values are returned in the oject’s instance variables.

XML: returns <ClipInfo> root element, <ClipID>, <FileName>, <Start>, <End> sub elements

GetClipInfoEx

ActiveX VB	vbx. GetClipInfoEx (szClipName As String, ByRef lCreation As Long, ByRef lLastModification As Long, ByReg lFileSize As Long, ByRef lDiskFragments) As Long
ActiveX C++	Long pcx-> GetClipInfoEx (BSTR szClipName, long * lCreation, long * lLastModification, long * lFileSize, long * lDiskFragments)
Java	Not Implemented
Dll	Long vvwGetNextClipEx (long lChannel, char * szClipName, long * lCreation, long * lLastModification, long * lFileSize, long * lDiskFragments)
Unix	Long GetNextClipEx (char * szClipName, long * lCreation, long * lLastModification, long * lFileSize, long * lDiskFragments)
XML	Not supported

Retuns the extended information from szClip. The information is located in lStart, lEnd, lVidEdit, lAudEdit and szFileName as time of creation, last modified date, the file size, and the number of fragments in the file respectively.

Returns 0 if successful, else an error code.

CopyClip

ActiveX VB	vbx. CopyClip (szSourceClip As String, szDestClip As String, lStart As Long, lEnd As Long) As long
ActiveX C++	Long pcx-> CopyClip (BSTR szSourceClip, BSTR szDestClip, long lStart, long lEnd)
Java	Long mci. CopyClip (String szSourceClip, String szDestClip, long lStart, long lEnd)
Dll	Long vvwCopyClip (long lChannel, char * szSourceClip, char * szDestClip, long lStart, long lEnd)
Unix	Long CopyClip (char * szSourceClip, char * szDestClip, long lStart, long lEnd)
XML	Not supported

Create a virtual copy of a clip, changing the in and out points if necessary. To use the whole clip, set lStart to 0 and the end to –1.

Returns 0 if successful, else an error code.

VTR Mode Operations

EDLResetToStart

ActiveX VB	Vbx. EDLResetToStart () As Long
ActiveX C++	Long pcx-> EDLResetToStart ()
Java	Long mci. EDLResetToStart ()
Dll	Long vvwEDLResetToStart (long lChannel)
Unix	Long EDLResetToStart ()
XML	Not supported

Reset the edl returns in VTR mode to the first element of the list.

EDLGetEdit

ActiveX VB	Vbx. EDLGetEdit (ByRef lRecordIn As Long, ByRef lPlayIn As Long, ByRef lPlayOut As Long, ByRef lVidEdit As Long, ByRef lAudEdit As Long, ByRef lInfEdit As Long, ByRef szClipName As String, ByRef szFileName As Long) As Long
ActiveX C++	Long pcx-> EDLGetEdit (long * lRecordIn, long * lPlayIn, long * lPlayOut, long * lVidEdit, long * lAudEdit, long * lInfEdit, BSTR * szClipName, BSTR * szFileName)
Java	long mci. EDLGetEdit (VTREditLine editInfo)
Dll	long vvwEDLGetEdit (long lChannel, long * lRecordIn, long * lPlayIn, long * lPlayOut, long * lVidEdit, long * lAudEdit, long * lInfEdit, char * sz8CharClipName, char * sz260CharFileName)
Unix	Long EDLGetEdit (long * lRecordIn, long * lPlayIn, long * lPlayOut, long * lVidEdit, long * lAudEdit, long * lInfEdit, char * szClipName, char * szFileName)
XML	http://localhost/VVWXMLEDLInfo?position=0 &videochannels=0&audiochannels=0&infochannels=0

Returns an edit line from the VTR space of an internal channel. The function will continue to return the next edit in the timecode space until the last edit is returned, after which an error will be returned. To reset to the start of the Edl use EDLResetToStart.

Returns 0 if successfule else an Error code.

Java: This method requires the user to instantiate a new object of type VTREditLine. The lRecordIn, lPlayIn, lPlayOut, lVidEdit, lAudEdit, lInfEdit, szClipName, and szFileName values are returned in the oject’s instance variables of the same name.

VVWXMLEDLInfo returns XML with a <MediaCmd> root element, for example:

<?xml version="1.0" ?>

- <MediaCmd>

- <!-- Drastic MEDIACMD xml structure version 1,0

-->

<Cmd Value="14" UseClipID="1">GetValue</Cmd>

<FileName>V:\Drastic Base Media\avi_er001_720x486_YUY2.avi</FileName>

</MediaCmd>

Shared Operations

GetLastChangeMs

ActiveX VB	vbx. GetLastChangeMs () As Long
ActiveX C++	long pcx-> GetLastChangeMs ()
Java	long mci. GetLastChangeMs ()
Dll	long vvwGetLastChangeMs (long lChannel)
Unix	long GetLastChangeMs ()
XML	Not supported

Returns the millisecond time of the last change in the current mode (clip or vtr).

Insert

ActiveX VB	vbx. Insert (szClipName As String, szFileName As String, lPosition As Long, lStart As Long, lEnd As Long, lVidEdit As Long, lAudEdit As Long, lInfEdit As Long, fRipple As Boolean) As Long
ActiveX C++	long pcx-> Insert (BSTR szClipName, BSTR szFileName, long lPosition, long lStart, long lEnd, long lVidEdit, long lAudEdit, long lInfEdit, BOOl fRipple)
Java	long mci. Insert (String szClipName, String szFileName, long lPosition, long lStart, long lEnd, long lVidEdit, long lAudEdit, long lInfEdit, Boolean fRipple)
Dll	long vvwInsert (long lChannel, char * szClipName, char * szFileName, long lPosition, long lStart, long lEnd, long lVidEdit, long lAudEdit, long lInfEdit, BOOl fRipple)
Unix	long Insert (char * szClipName, char * szFileName, long lPosition, long lStart, long lEnd, long lVidEdit, long lAudEdit, long lInfEdit, VVWBOOl fRipple)
XML	http://localhost/VVWXMLMediaCmd?Insert &ClipID=szClipName&position=lPosition &start=lStart&end=lEnd&videochannels=lVidEdit &audiochannels=lAudEdit&infochannels=lInfEdit &Flags=Ripple

Internal Channels Only. Do not use yet.

Blank

ActiveX VB	vbx. Blank (szClipName As String, lStart As Long, lEnd As Long, lVidEdit As Long, lAudEdit As Long, lInfEdit As Long, fRipple As Boolean) As Long
ActiveX C++	long pcx-> Blank (BSTR szClipName, long lStart, long lEnd, long lVidEdit, long lAudEdit, long lInfEdit, BOOl fRipple)
Java	long mci. Blank (String szClipName, long lStart, long lEnd, long lVidEdit, long lAudEdit, long lInfEdit, Boolean fRipple)
Dll	long vvwBlank (long lChannel, char * szClipName, long lStart, long lEnd, long lVidEdit, long lAudEdit, long lInfEdit, BOOl fRipple)
Unix	long Blank (char * szClipName, long lStart, long lEnd, long lVidEdit, long lAudEdit, long lInfEdit, VVWBOOl fRipple)
XML	http://localhost/VVWXMLMediaCmd?Blank &ClipID=szClipName&position=lPosition &start=lStart&end=lEnd&videochannels=lVidEdit &audiochannels=lAudEdit&infochannels=lInfEdit &Flags=Ripple

Internal Channels Only. Do not use yet.

Delete

ActiveX VB	vbx. Delete (szClipName As String, lStart As Long, lEnd As Long, lVidEdit As Long, lAudEdit As Long, lInfEdit As Long, fRipple As Boolean) As Long
ActiveX C++	long pcx-> Delete (BSTR szClipName, long lStart, long lEnd, long lVidEdit, long lAudEdit, long lInfEdit, BOOl fRipple)
Java	long mci. Delete (String szClipName, long lStart, long lEnd, long lVidEdit, long lAudEdit, long lInfEdit, Boolean fRipple)
Dll	long vvwDelete (long lChannel, char * szClipName, long lStart, long lEnd, long lVidEdit, long lAudEdit, long lInfEdit, BOOl fRipple)
Unix	long Delete (char * szClipName, long lStart, long lEnd, long lVidEdit, long lAudEdit, long lInfEdit, VVWBOOl fRipple)
XML	http://localhost/VVWXMLMediaCmd?Delete &ClipID=szClipName&position=lPosition &start=lStart&end=lEnd&videochannels=lVidEdit &audiochannels=lAudEdit&infochannels=lInfEdit &Flags=Ripple

Internal Channels Only. Do not use yet.

Trim

ActiveX VB	vbx. Trim (lPosition As Long, lStartOffset As Long, lEndOffset As Long, lVidEdit As Long, lAudEdit As Long, lInfEdit As Long, fRipple As Boolean) As Long
ActiveX C++	long pcx-> Trim (long lPosition, long lStartOffset, long lEndOffset, long lVidEdit, long lAudEdit, long lInfEdit, BOOl fRipple)
Java	long mci. Trim (long lPosition, long lStartOffset, long lEndOffset, long lVidEdit, long lAudEdit, long lInfEdit, Boolean fRipple)
Dll	long vvwTrim (long lChannel, long lPosition, long lStartOffset, long lEndOffset, long lVidEdit, long lAudEdit, long lInfEdit, BOOl fRipple)
Unix	long Trim (long lPosition, long lStartOffset, long lEndOffset, long lVidEdit, long lAudEdit, long lInfEdit, VVWBOOl fRipple)
XML	http://localhost/VVWXMLMediaCmd?Trim &position=lPosition&start=lStartOffset &end=lEndOffset&videochannels=lVidEdit &audiochannels=lAudEdit&infochannels=lInfEdit &Flags=Ripple

Internal Channels Only. Do not use yet.

Settings

The ‘Value’ commands allow settings to be changed on a particular channel. The most common settings have been made into functions, but all settings use ValueSupported, ValueMin, ValueMax, ValueGet and ValueSet. Most applications will only require the functions below. If an extended settings is required, please see the MediaCmd reference.

ValueSupported

ActiveX VB	vbx. ValueSupported (lValueType As Long) As Long
ActiveX C++	long pcx-> ValueSupported (long lValueType)
Java	long mci. ValueSupported (long lValueType)
Dll	long vvwValueSupported (long lChannel, long lValueType)
Unix	long ValueSupported (long lValueType)
XML	http://localhost/ValueSupported&cmdalt=valuetype &position=lValueType

Returns the supported attributes of a get/set value (gsClipMode, gsTcSource, etc) or –1 for not supported.

ValueGet

ActiveX VB	vbx. ValueGet (lValueType As Long, ByRef lMin As Long, ByRef lMax As Long) As Long
ActiveX C++	long pcx-> ValueGet (long lValueType, long * plMin, long * plMax)
Java	long mci. ValueGet (GetValueMcmd mCmdValues)
Dll	long vvwValueGet (long lChannel, long lValueType, long * plMin, long * plMax)
Unix	long ValueGet (long lValueType, long * plMin, long * plMax)
XML	http://localhost/GetValue&cmdalt=valuetype &position=lValueType

Returns the current setting for a get/set value.

Java: This method requires the user to instantiate a new object of type GetValueMcmd. The plMin and plMax values are returned in the oject’s instance variables: plMin and plMax.

ValueSet

ActiveX VB	vbx. ValueSet (lValueType As Long, lSetting As Long) As Long
ActiveX C++	long pcx-> ValueSet (long lValueType, long lSetting)
Java	long mci. ValueSet (long lValueType, long lSetting)
Dll	long vvwValueSet (long lChannel, long lValueType, long lSetting)
Unix	long ValueSet (long lValueType, long lSetting)
XML	http://localhost/SetValue&cmdalt=valuetype &position=lSetting

Sets the get/set value to setting.

ValueSet2

ActiveX VB	vbx. ValueSet2 (lValueType As Long, lSetting As Long, lStart As Long, lEnd As Long, lVidChannel As Long, lAudChannel As Long, lInfChannel As Long) As Long
ActiveX C++	long pcx-> ValueSet2 (long lValueType, long lSetting, long lStart, long lEnd, long lVidChannel, long lAudChannel, long lInfChannel)
Java	long mci. ValueSet2 (long lValueType, long lSetting, long lStart, long lEnd, long lVidChannel, long lAudChannel, long lInfChannel)
Dll	long vvwValueSet2 (long lChannel, long lValueType, long lSetting, long lStart, long lEnd, long lVidChannel, long lAudChannel, long lInfChannel)
Unix	long ValueSet2 (long lValueType, long lSetting, long lStart, long lEnd, long lVidChannel, long lAudChannel, long lInfChannel)
XML	Not supported – see ValueSet

Sets the get/set value to setting with extended parameters. Please set unused parameters to NULL.

Settings Format

All the settings, except where noted, have the following format:

ActiveX VB	Vbx. GetXXX () As Long
	Vbx. SetXXX (lSetting As Long) As Long
ActiveX C++	Long pcx-> GetXXX ()
	Long pcx-> SetXXX (long lSetting)
Java	Long mci. GetXXX ()
	Long mci. SetXXX (long lSetting)
Dll	Long vvwGetXXX ()
	Long vvwSetXXX (long lSetting)
Unix	Long GetXXX ()
	Long SetXXX (long lSetting)

Base Settings

ClipMode

Calls ValueXXX with gsClipMode. If equal to 1 then the channel is in clip mode, if 0 the channel is in VTR mode.

(XML: localhost/XMLMediaCmd?SetValue&cmdalt=clipmode&position=0)

Get/SetTCType

Calls ValueXXX with gsTcType (drop frame, non drop frame, pal).

#define TC2_TCTYPE_MASK 0x000000FF

#define TC2_TCTYPE_FILM 0x00000001 // 24 fps

#define TC2_TCTYPE_NDF 0x00000002 // NTSC Non Drop Frame

#define TC2_TCTYPE_DF 0x00000004 // NTSC Drop Frame

#define TC2_TCTYPE_PAL 0x00000008 // PAL

#define TC2_TCTYPE_50 0x00000010 // PAL (double rate)

#define TC2_TCTYPE_5994 0x00000020 // NTSC 59.94fps 720p

#define TC2_TCTYPE_60 0x00000040 // NTSC 60fps 720p

#define TC2_TCTYPE_NTSCFILM 0x00000080 // NTSC FILM 23.97

(XML: localhost/XMLMediaCmd?SetValue&cmdalt=tctype&position=2)

Get/SetTCSource

Calls ValueXXX with gsTcSource (VITC, LTC, Control, Clip).

//! For cmdGetSetValue::gsTcSource - Using LTC

#define GS_TCSOURCE_LTC 1

//! For cmdGetSetValue::gsTcSource - Using VITC

#define GS_TCSOURCE_VITC 2

//! For cmdGetSetValue::gsTcSource - Using CTL

#define GS_TCSOURCE_CTL 4

//! For cmdGetSetValue::gsTcSource - Using absolute clip

#define GS_TCSOURCE_CLIP 7

(XML: localhost/XMLMediaCmd?GetValue&cmdalt=tcsource)

Get/SetAutoMode

Calls ValueXXX with gsAutoMode. Required for play lists, deferred commands and auto edit commands on VTRs.

GetAvailablePresets

ADD FUNCTIONS lVidEdit, lAudEdit, lInfEdit

Returns the supported audio, video and info presets for a channel.

Java: Values for audio, video and info presets are returned in variable members of the class mci.AvailablePresets.

Audio Settings

Get/SetAudioInput

ADD FUNCTION lAudIn

Get the current audio input.

Java: Must indicate the channel(s) to get/set. This is achieved by sending a long value representing the channel(s) you wish to get/set. For example if you wish to set audio channels 1 and 4 set the audChannels paramater to 9 (1001). You may also use the predefined audio channel defenitions in the MEDIACMD structure (audChanX, where x is the audio channel - 1).

//! Audio in/out unbalanced (RCA connector) high impedence at -10db (cmdGetSetValue::gsAudInSelect cmdGetSetValue::gsAudOutSelect)

#define GS_AUDSELECT_UNBALANCED_10 0x001

//! Audio in/out unbalanced (RCA connector) high impedence at -4db (cmdGetSetValue::gsAudInSelect cmdGetSetValue::gsAudOutSelect)

#define GS_AUDSELECT_UNBALANCED_4 0x002

//! Audio in/out balanced (XLR connector) 600ohm impedence at -10db (cmdGetSetValue::gsAudInSelect cmdGetSetValue::gsAudOutSelect)

#define GS_AUDSELECT_BALANCED_10 0x010

//! Audio in/out balanced (XLR connector) 600ohm impedence at +4db (cmdGetSetValue::gsAudInSelect cmdGetSetValue::gsAudOutSelect)

#define GS_AUDSELECT_BALANCED_4 0x020

//! Audio in/out digital single wire (cmdGetSetValue::gsAudInSelect cmdGetSetValue::gsAudOutSelect)

#define GS_AUDSELECT_SPDIF 0x100

//! Audio in/out digital balanced with clock (cmdGetSetValue::gsAudInSelect cmdGetSetValue::gsAudOutSelect)

#define GS_AUDSELECT_AES_EBU 0x200

//! Audio in/out embedded in SDI or HD-SDI video signal (cmdGetSetValue::gsAudInSelect cmdGetSetValue::gsAudOutSelect)

#define GS_AUDSELECT_EMBEDDED 0x400

//! No audio in/out available, or cannot be configured (cmdGetSetValue::gsAudInSelect cmdGetSetValue::gsAudOutSelect)

#define GS_AUDSELECT_NONE 0

(XML: localhost/XMLMediaCmd?SetValue&cmdalt=gsAudInSelect&position=lSetting

&videochannels=0&audiochannels=lAudChannels&infochannels=0)

Get/SetAudioInputLevel

Get the current audio input level

Note: There are two get methods, one method will only return the current level.

The second method will return the current level as well as the max and min values for the audio channel in the GetValueMcmd object.

(XML: localhost/XMLMediaCmd?SetValue&cmdalt=gsAudInputLevel&position=lSetting

&videochannels=0&audiochannels=lAudChannels&infochannels=0)

Get/SetAudioOutput

Get the current audio Output – See Get/SetAudioInput

Note: There are two get methods, one method will only return the current level.

The second method will return the current level as well as the max and min values for the audio channel in the GetValueMcmd object.

(XML: localhost/XMLMediaCmd?SetValue&cmdalt=gsAudOutSelect&position=lSetting

&videochannels=0&audiochannels=lAudChannels&infochannels=0)

Get/SetAudioOutputLevel

Get the current audio output level.

Note: There are two get methods, one method will only return the current level.

The second method will return the current level as well as the max and min values for the audio channel in the GetValueMcmd object.

(XML: localhost/XMLMediaCmd?SetValue&cmdalt=gsAudOutputLevel&position=lSetting

&videochannels=0&audiochannels=lAudChannels&infochannels=0)

GetAudioPeakRMS

Returns the RMS and Peak audio levels of the input (stop/record) or output (play/pause).

(XML: localhost/XMLMediaCmd?GetValue&cmdalt=gsAudWavePeakRMS)

Video Settings

Get/SetVideoInput

Get the current video input.

//! Standard NTSC or PAL composite video (cmdGetSetValue::gsVidInSelect cmdGetSetValue::gsVidOutSelect)

#define GS_VIDSELECT_COMPOSITE 0x001

//! SVHS/S-Video four wire NTSC or PAL video (cmdGetSetValue::gsVidInSelect cmdGetSetValue::gsVidOutSelect)

#define GS_VIDSELECT_SVIDEO 0x002

//! Secondary NTSC or PAL video (often monitor selection) (cmdGetSetValue::gsVidInSelect cmdGetSetValue::gsVidOutSelect)

#define GS_VIDSELECT_COMPOSITE_2 0x004

//! BetaCam level YCrCb NTSC or PAL video (cmdGetSetValue::gsVidInSelect cmdGetSetValue::gsVidOutSelect)

#define GS_VIDSELECT_COMPONENT_YUV 0x010

//! Panasonic M2 level YCrCb NTSC or PAL video (cmdGetSetValue::gsVidInSelect cmdGetSetValue::gsVidOutSelect)

#define GS_VIDSELECT_COMPONENT_YUV_M2 0x020

//! SMPTE standard level YCrCb NTSC or PAL video (cmdGetSetValue::gsVidInSelect cmdGetSetValue::gsVidOutSelect)

#define GS_VIDSELECT_COMPONENT_YUV_SMPTE 0x040

//! RGB at video standard rate (cmdGetSetValue::gsVidInSelect cmdGetSetValue::gsVidOutSelect)

#define GS_VIDSELECT_COMPONENT_RGB 0x080

//! D1 Serial Digital or HDSDI video (cmdGetSetValue::gsVidInSelect cmdGetSetValue::gsVidOutSelect)

#define GS_VIDSELECT_D1_SERIAL 0x100

//! D1 Serial Parallel video (cmdGetSetValue::gsVidInSelect cmdGetSetValue::gsVidOutSelect)

#define GS_VIDSELECT_D1_PARALLEL 0x200

//! SDTI/SDI including high speed transfer video (cmdGetSetValue::gsVidInSelect cmdGetSetValue::gsVidOutSelect)

#define GS_VIDSELECT_SDTI 0x400

//! No video available or no configurable settings (cmdGetSetValue::gsVidInSelect cmdGetSetValue::gsVidOutSelect)

#define GS_VIDSELECT_NONE 0

(XML: localhost/XMLMediaCmd?SetValue&cmdalt=gsVidInSelect

&position=lSetting)

Get/SetVideoOutput

Get the current video output. See Get/SetVideoInput for settings.

Get/SetVideoInputSetup

Get the current video input’s ‘Setup’ TBC setting.

Java: There are two get methods, one method will only return the current level. The second method will return the current level as well as the max and min values for the Setup in the GetValueMcmd object.

(XML: localhost/XMLMediaCmd?SetValue&cmdalt=gsVidInSetup&position=lSetting)

Get/SetVideoInputVideo

Get the current video input’s ‘Video’ TBC setting.

Java: There are two get methods, one method will only return the current level.

The second method will return the current level as well as the max and min values for the Video in the GetValueMcmd object.

(XML: localhost/XMLMediaCmd?SetValue&cmdalt=gsVidInVideo

&position=lSetting)

Get/SetVideoInputHue

Get the current video input’s ‘Hue’ TBC setting.

Java: There are two get methods, one method will only return the current level.

The second method will return the current level as well as the max and min values for the Hue in the GetValueMcmd object.

(XML: localhost/XMLMediaCmd?SetValue&cmdalt=gsVidInHue

&position=lSetting)

Get/SetVideoInputChroma

Get the current video input’s ‘Chroma’ TBC setting.

Java: There are two get methods, one method will only return the current level.

The second method will return the current level as well as the max and min values for the Chroma in the GetValueMcmd object.

(XML: localhost/XMLMediaCmd?SetValue&cmdalt=gsVidInChroma

&position=lSetting)

Get/SetVideoTBCSetup

Get the current global TBC’s ‘Setup’ setting.

Java: There are two get methods, one method will only return the current level.

The second method will return the current level as well as the max and min values for the Setup in the GetValueMcmd object.

(XML: localhost/XMLMediaCmd?SetValue&cmdalt=gsVidSetup&position=lSetting)

Get./SetVideoTBCVideo

Get the current global TBC’s ‘Video’ setting.

Java: There are two get methods, one method will only return the current level.

The second method will return the current level as well as the max and min values for the Videoin the GetValueMcmd object.

(XML: localhost/XMLMediaCmd?SetValue&cmdalt=gsVidVideo&position=lSetting)

Get/SetVideoTBCHue

Get the current global TBC’s ‘Hue’ setting.

Java: There are two get methods, one method will only return the current level.

The second method will return the current level as well as the max and min values for the Hue in the GetValueMcmd object.

(XML: localhost/XMLMediaCmd?SetValue&cmdalt=gsVidHue&position=lSetting)

Get/SetVideoTBCChroma

Get the current global TBC’s ‘Chroma’ setting.

Java: There are two get methods, one method will only return the current level.

The second method will return the current level as well as the max and min values for the Chroma in the GetValueMcmd object.

(XML: localhost/XMLMediaCmd?SetValue&cmdalt=gsVidChroma

&position=lSetting)

Get/SetVideoGenlock

Turn the house/reference lock on or off

Get/SetVideoGenlockSource

Set the source to input or external genlock

Error Log

vvwGetErrorLogMs

Get the ms time the last error was added to the error log

vvwSetErrorLog

Set the error log pointer to the message you want

vvwGetErrorLength

Get the length of the current error string

vvwGetError

Get the current error. Sets pointer to the next one automatically

System Settings

Get/SetCompressionRate

Get or set the current compression rate.

Get/SetSuperImpose

Enable or disable the time code super impose on the main output.

GetTotalTime

Returns the total number of frames of storage available at current compression rate if the storage space was empty.

GetFreeTime

Returns the remaining number of frames of storage available at current compression rate.

GetTotalStorage

Returns the total storage connected in megabytes.

GetFreeStorage

Returns the amount of available storage for recording in megabytes.

GetCurMs

Get the current millisecond time.

GetChannelCapabilities

Get the available commands for a channel.

GetVVWVersion

Returns the version string of the VVW subsystem.

GetMRVersion

Returns the version string of the MediaReactor subsystem.

GetVVWType

Returns the type string of the VVW channel.

Utility Functions

FreeString

ActiveX VB	Not implemented
ActiveX C++	Not implemented
Java	Not implemented
Dll	Void vvwFreeString (char * szString)
Unix	Void FreeString (char * szString)
XML	Not supported

Free a string value returned by the channel.

TCMaxFrame

ActiveX VB	vbx. TCMaxFrame (lFlags As Long) As Long
ActiveX C++	long pcx-> TCMaxFrame (long lFlags)
Java	long mci. TCMaxFrame (long lFlags)
Dll	Use TCXlat
Unix	Long TCMaxFrame (long lFlags)
XML	Not supported

Returns the maximum possible frame value for a time code type. See TCToFrame for flag definitions.

TCToFrame

ActiveX VB	vbx. TCToFrame (szTC As String, lFlags As Long) As Long
ActiveX C++	Long pcx-> TCToFrame (BSTR szTC, long lFlags)
Java	Long mci. TCToFrame (String szTC, long lFlags)
Dll	Use TCXlat
Unix	Long TCToFrame (char * szTC, long lFlags)
XML	Not supported

Convert a time code string to a frame count based on the flags.

Flags:

TC2_TCTYPE_MASK 0x000000FF

TC2_TCTYPE_FILM 0x00000001 // 24 fps

TC2_TCTYPE_NDF 0x00000002 // NTSC Non Drop Frame

TC2_TCTYPE_DF 0x00000004 // NTSC Drop Frame

TC2_TCTYPE_PAL 0x00000008 // PAL

TC2_TCTYPE_50 0x00000010 // PAL 720p (double rate)

TC2_TCTYPE_5994 0x00000020 // NTSC 59.94fps 720p

TC2_TCTYPE_60 0x00000040 // NTSC 60fps 720p

TC2_TCTYPE_NTSCFILM 0x00000080 // NTSC FILM 23.97

TC2_FTYPE_FIELD 0x10000000 // Field based (else frame)

// Basic sting tc representation types

TC2_STRTYPE_MASK 0x00000F00

TC2_STRTYPE_ASCII 0x00000100 // Std ascii string

TC2_STRTYPE_BCD 0x00000200 // RS-422 BCD or Packed

TC2_STRTYPE_HEX 0x00000400 // Hex packed DWORD

TC2_STRTYPE_GOP 0x00000800 // MPEG Gop TC

TC2_STRTYPE_INVERT 0x00001000 // Frames first

// Extended string handling

TC2_STREXT_MARKS 0x00010000 // Add : marks in string

TC2_STREXT_LEADING 0x00020000 // Include leading 0s

TC2_STREXT_TYPE 0x00040000 // Add ' N', ' D', ' P' or ' F' at end

TC2_STREXT_ALLCOLON 0x00080000 // No -.; just :

TC2_STREXT_FLAG 0x00100000 // Add DF Flag in BCD

TC2_STREXT_CF 0x00200000 // Add CF Flag in BCD

TC2_STREXT_MAX30 0x00400000 // Max 29 frames for output

TC2_STREXT_SHIFT7 0x40000000 // GOP Tc is shifted in DWORD

TC2_STREXT_SAVEBITS 0x80000000 // GOP Save unused bits

TCToString

ActiveX VB	vbx. TCToString (lTC As Long, lFlags As Long) As String
ActiveX C++	BSTR pcx-> TCToString (long lTC, long lFlags)
Java	String mci. TCToString (long lTC, long lFlags)
Dll	Use TCXlat
Unix	Char * TCToString (long lTC, long lFlags)
XML	Not supported

Convert a frame count to a time code string based on the flags. See TCToFrame for flag definitions.

VVWSpeedToPercentage

ActiveX VB	vbx. VVWSpeedToPercentage (lVVWSpeed As Long) As Double
ActiveX C++	Double pcx-> VVWSpeedToPercentage (long lVVWSpeed)
Java	Double mci. VVWSpeedToPercentage (long lVVWSpeed)
Dll	Not implemented
Unix	Double VVWSpeedToPercentage (long lVVWSpeed)
XML	Not supported

Convert a VVW speed (65520 based) to a percentage based speed (100.0).

PercentageToVVWSpeed

ActiveX VB	vbx. PercentageToVVWSpeed (double ddPercentageSpeed) As Long
ActiveX C++	Long pcx-> PercentageToVVWSpeed (double ddPercentageSpeed)
Java	Long mci. PercentageToVVWSpeed (double ddPercentageSpeed)
Dll	Not implemented
Unix	Long PercentageToVVWSpeed (double ddPercentageSpeed)
XML	Not supported

Convert a percentage speed (100.0) to a VVW speed (65520)

Java Data Structure Definitions

ClipInfo

Java	MediaCmdIF.ClipInfo clipData = new MediaCmdIF.ClipInfo(szClipName)

For use with the mci.GetClipInfo method. Must construct this data structure with a valid clip name.

Data members

String szClipName: clip name. This must be set to a valid clip name when a call is made

to the mci.GetClipInfo method.

long lStart: the in point of the inquired clip.

long lEnd: the out point of the inquired clip.

long lVidEdit: number of video channels available for the requested clip.

long lAudEdit: number of audiochannels available for the inquired clip.

long lInfEdit: number of info channels available for the inquired clip.

String szFileName: file name of the requested clip.

VTREditLine

Java	MediaCmdIF.VTREditLine editInfo = new MediaCmdIF.VTREditLine();

For use with the mci.EDLGetEdit method. Values for the EDLGetEdit method are returned in the object’s instance variables. The mci.EDLGetEdit method returns 0 for a successful retrieval and –1 on error. The VTREditLine instance variable will be set to null on error and will contain valid data on success.

Data members

long lRecordIn: time code on the VTR edit line.

long lPlayIn: the in point of the VTR edit line.

long lPlayOut: the out point of the VTR edit line.

long lVidEdit: number of video channels available for the VTR edit line.

long lAudEdit: number of audio channels available for the VTR edit line.

long lInfEdit: number of info channels available for the VTR edit line.

String szClipName: clip name of the current VTR edit line .

String szFileName: file name of the current VTR edit line.

GetValueMcmd

Java	MediaCmdIF.GetValueMcmd mCmdValues = new MediaCmdIF.GetValueMcmd(setValueType, pMin, pMax)

For use with the mci.ValueGet method. Must construct this data structure with a valid lValueType. If the min value of the get/set value is needed construct the GetValueMcmd instance with pMin different than –1. If the max value of the get/set value is needed construct the GetValueMcmd instance with pMax different than –1.

Instantiating the GetValueMcmd with values of –1 for the pMin and/or pMax parameters will result in an invalid return for these instance variables.

Data members

long lValueType: the get/set value. Used by the mci.ValueGet method to determine

which setting to retrieve.

long plMin: stores the min value for a get/set value if instantiated with a value different

than –1.

long plMax: stores the max value for a get/set value if instantiated with a value different

than –1.

AvailabePresets

Java	MediaCmdIF.AvailablePresets presets = new MediaCmdIF.AvaiablePresets()

For use with the mci.GetAvaolablePresets method. Values for the GetAvailablePresets method are returned in the object’s instance variables.

Data members

long plVidEdit: supported video presets for a channel

long plAudEdit: supported audio presets for a channel

long plInfEdit: supported info presets for a channel

Appendix I – MediaCmd.h

Please see included file MediaCmd.chm (Doxygen)

Appendix II – MediaCmdX.h

Please see help file MediaCmd.chm (JavaDoc)

Appendix III – VVWIF.h

/**

* Convert a 0..3 channel to 0, 64, 65536

* Mostly internal

* Undocumented

void * __stdcall vvwChannelToHandle(long lChannel);

/**

* Convert a 0, 64, 65536 to 0..3

* Mostly internal

* Undocumented

long __stdcall vvwHandleToChannel(void * hVvw);

/**

long __stdcall vvwEnableChannels(long lInternal0_31,

long lInternal32_63,

long lExternal64_95,

long lExternal96_127,

long lNetwork128_159,

long lNetwork160_191);

/**

* Release memory allocated to channels

long __stdcall vvwReleaseChannels(void);

/**

long __stdcall vvwGetMaxChannels(void);

/**

long __stdcall vvwGetChannelName(long lChannel, char * szChannelName);

/**

Returns the basic type of the channel (VTR, Internal, User, House)

VVW_CHANTYPE_HOUSE 0x1 1

VVW_CHANTYPE_INTERNAL 0x2 2

VVW_CHANTYPE_VTR_DDR 0x4 4

VVW_CHANTYPE_UNKNOWN 0xFFFFFFFF -1

long __stdcall vvwGetChannelType(long lChannel);

/**

long __stdcall vvwShowConfigDialog(long lChannel, long hWnd);

// Transport

/**

Play at normal speed.

Returns 0 if successful, else an error code.

long __stdcall vvwPlay(long lChannel);

/**

Returns 0 if successful, else an error code.

long __stdcall vvwPlayAtSpeed(long lChannel, long lVVWSpeed);

/**

PlayFromTos to be stacked so that they will play back to back. The deferred flag in the status return should be false before another deferred command is added.

Returns 0 if successful, else an error code.

long __stdcall vvwPlayFromTo(long lChannel, long lFrom, long lTo, BOOL fDeferred);

/**

Clip Mode Only. Load a clip into the channel and display the lStartFrame.

Returns 0 if successful, else an error code.

long __stdcall vvwLoadClip(long lChannel, char * sz8CharClipName, long lStartFrame);

/**

Clip Mode Only. Play the entire clip specified by clip name. If the deferred flag is true, clip playback will only occur once the currently playing clip has finished. If there is no currently playing clip, playback will occur immediately.

Returns 0 if successful, else an error code.

long __stdcall vvwPlayClip(long lChannel, char * sz8CharClipName, BOOL fDeferred);

/**

Clip Mode Only. Play the specified portion of the clip specified by clip name. If the deferred flag is true, clip playback will only occur once the currently playing clip has finished. If there is no clip currently playing, playback will occur immediately.

Returns 0 if successful, else an error code.

long __stdcall vvwPlayClipFromTo(long lChannel, char * sz8CharClipName, long lFrom, long lTo, BOOL fDeferred);

/**

Set the channel into its fastest possible forward motion state.

Returns 0 if successful, else an error code.

long __stdcall vvwFastForward(long lChannel);

/**

Set the channel into its fastest possible reverse motion state.

Returns 0 if successful, else an error code.

long __stdcall vvwFastRewind(long lChannel);

/**

Stop playback and display the current frame.

Returns 0 if successful, else an error code.

long __stdcall vvwPause(long lChannel);

/**

Seek to a particular frame and display it to the user. This call will return before the seek is complete. Once the Position return in the status reaches the lFrame, the seek is complete.

Returns 0 if successful, else an error code.

long __stdcall vvwSeek(long lChannel, long lFrame);

/**

Seek a certain number of frames from the current position. Positive offsets imply forward direction, negative offset imply reverse.

long __stdcall vvwSeekRelative(long lChannel, long lFrameOffset);

/**

Stop the output of the controlled channel and display the input video (not supported on all devices). On unsupported devices stop will be the same as a pause.

Returns 0 if successful, else an error code.

long __stdcall vvwStop(long lChannel);

/**

Start the channel recording. In clip mode a default clip name will be used with a duration set to infinity. The record will stop on any transport command or at the point that the disk is full.

Returns 0 if successful, else an error code.

long __stdcall vvwRecord(long lChannel);

/**

Returns 0 if successful, else an error code.

long __stdcall vvwRecordFromTo(long lChannel, long lFrom, long lTo);

/**

Clip Mode Only. Set the clip name and length of time to record in frames. The record will not actually start until Record() is called. If the lDuration is set to –1 the record will continue until Stop() is called or the channel runs out of space.

Returns 0 if successful, else an error code.

long __stdcall vvwRecordStop(long lChannel, char * sz8CharClipName, long lDuration);

/**

Set the channels to record. Using –1 values implies that the Preset should be set to all available channels. Record Presets will remain set until the user changes them.

Returns 0 if successful, else an error code.

long __stdcall vvwSetRecordPresets(long lChannel, long lVidEdit, long lAudEdit, long lInfEdit);

/**

Eject the current media if it is removable. Normally only used with VTRs.

Returns 0 if successful, else an error code.

long __stdcall vvwEject(long lChannel);

/**

* MediaCmd direct access

long __stdcall vvwMediaCmd(long lChannel, void * pMediaCmd);

// Special Commands (lChannel must be vtr type, lTargetChannel must be internal type)

/**

Returns 0 if successful, else an error code.

long __stdcall vvwTransfer(long lChannel, long lTargetChannel, long lPosition, long lStart, long lEnd, long lVidEdit, long lAudEdit, long lInfEdit, char * szClipName, BOOL fToTape);

/**

Retrieve the current status from the controlled device. The status is automatically updated by the interface, but this call ensures that the status is current when you are checking it.

Returns 0 if successful, else an error code.

long __stdcall vvwUpdateStatus(long lChannel);

/**

Returns the current state

ctStop 0 // Stop all action

ctPause 1 // Pause, Seek

ctPlay 2 // Play at specified speed (includes pause)

ctRecord 3 // Record at specified speed

ctRecStop 4 // Stop ready for recording

ctEject 5 // Eject the current media

ctError 17 // An error has occurred

ctAbort 19 // Abort any queued commands

long __stdcall vvwGetState(long lChannel);

/**

Returns the current flags

cfDeferred = 1, // 0x00000001 This is a delayed

cfOverideDeferred = 1 << 30,// 0x40000000 Overide all previous deferred commands

cfTimeMs = 1 << 1, // 0x00000002 Use Millisecond time for delayed time, not fields

cfTimeTarget = 1 << 2, // 0x00000004 Delayed time is offset from current time code

cfTimeHouseClock = 1 << 3, // 0x00000008 Delayed time is based on absolute (real) time

cfUseSpeed = 1 << 4, // 0x00000010 Set the new speed

cfUsePresets = 1 << 5, // 0x00000020 Use video and audio edit presets

cfUsePosition = 1 << 6, // 0x00000040 Use the position setting

cfUsePositionOffset = 1 << 7, // 0x00000080 Position is an offset

cfUseStart = 1 << 8, // 0x00000100 Start a new timecode

cfUseStartOffset = 1 << 9, // 0x00000200 Start is an offset from current tc

cfUseEnd = 1 << 10, // 0x00000400 End command as specified

cfUseEndOffset = 1 << 11, // 0x00000800 End is and offset from current tc

cfUseAllIDs = 1 << 12, // 0x00001000 Use all clip IDs

cfUseClipID = 1 << 13, // 0x00002000 Use new clip ID, otherwise use last or none

cfNoClipFiles = 1 << 14, // 0x00004000 Use new clip ID, otherwise use last or none

cfNoTCSpaces = 1 << 15, // 0x00008000 Use new clip ID, otherwise use last or none

cfUseCmdAlt = 1 << 16, // 0x00010000 Use the dwCmdAlt

cfIsShuttle = 1 << 17, // 0x00020000 Use speed in play for shuttle

cfFields = 1 << 20, // 0x00100000 Position, start and end are fields, not frames

cfRipple = 1 << 21, // 0x00200000 Ripple for insert or delete

cfLoop = 1 << 22, // 0x00400000 Loop the clip or in out

cfTrigger = 1 << 23, // 0x00800000 Trigger using dsync class

cfPreview = 1 << 24, // 0x01000000 Preview set (EE, non rt play)

cfInvert = 1 << 28, // 0x10000000 Invert a transfer

cfTest = 1 << 29, // 0x20000000 See if the command exists

cfNoReturn = 1 << 31, // 0x80000000 No return mediacmd is required

long __stdcall vvwGetFlags(long lChannel);

/**

D1Speed = ((double)VVWSpeed / 65520.0)

For percentages, where 100.0 represents play speed, use the following formula:

Dpercent = (((double)VVWSpeed * 100.0) / 65520.0)

= ((double)VVWSpeed / 655.2)

XML: See \<MediaCmd\> root element, \<Speed\> sub-element

Typical VVW speeds (note speeds are linear):

Pause 0% 0

Play 100% 65520

Half Play 50% 32760

Rev Play -100% -65520

Rev 2 x Play-200% 131040

10 x Play 1000% 655200

Max Play 90000% 5896800

Max Rev -90000%-5896800

long __stdcall vvwGetSpeed(long lChannel);

/**

Returns the current position if the cfUsePosition flag is set, otherwise invalid.

long __stdcall vvwGetPosition(long lChannel);

/**

Returns the millisecond time the last status occurred (time of the last vertical blank).

long __stdcall vvwGetLastMs(long lChannel);

/**

Returns the current start or in point if the cfUseStart flag is set.

long __stdcall vvwGetStart(long lChannel);

/**

Return the current end point or out point if cfUseEnd is set.

long __stdcall vvwGetEnd(long lChannel);

/**

Only supported in clip Mode. Returns the current clip name, if any. For dll access, the memory must be at least 9 bytes long (8 character bytes + NULL) and is always ANSI.

long __stdcall vvwGetClipName(long lChannel, char * sz8CharClipName);

/**

Returns the current file name, if any. For dll access, the memory must be at lease 261 bytes long (260 bytes max path + NULL) and is always ANSI.

long __stdcall vvwGetFileName(long lChannel, char * sz260CharFileName);

/**

Returns the current time code as a string (e.g. “00:01:00:00”). For dll access, the memory must always be at least 15 bytes long (14 byte time code plus id + NULL) and is always ANSI.

long __stdcall vvwGetCurTC(long lChannel, char * sz14ByteTC);

/**

Returns the current state as a string (e.g. “Play”). For dll access, the memory must always be at least 15 bytes long (14 byte state + NULL) and is always ANSI.

long __stdcall vvwGetCurState(long lChannel, char * sz14ByteState);

// Media Operation

// Clip Mode

/**

Clip Mode Only. Returns the next clip identifier. To get the first clip, szLastClip should be an empty string. Once the last clip available has been returned, GetNextClip will return an error or NULL for unix/dll access. Please note: For unix/dll access, the sz8CharLastClipCurClip memory area is used for the new clip. The previous clip name is therefore lost and the memory is not allocated by the vvw.

Returns 0 if successful, else an error code.

char * __stdcall vvwGetNextClip(long lChannel, char * sz8CharLastClipCurClip);

/**

Returns 0 if successful, else an error code.

long __stdcall vvwGetClipInfo (long lChannel, char * sz8CharClipName, long * lStart, long * lEnd, long * lVidEdit, long * lAudEdit, long * lInfEdit, char * szFileName);

/**

long __stdcall vvwGetNextClipEx (long lChannel, char * sz8CharClipName, long * lCreation, long * lLastModification, long * lFileSize, long * lDiskFragments);

/**

Create a virtual copy of a clip, changing the in and out points if necessary. To use the whole clip, set lStart to 0 and the end to –1.

Returns 0 if successful, else an error code.

long __stdcall vvwCopyClip (long lChannel, char * szSourceClip, char * szDestClip, long lStart, long lEnd);

// VTR Mode

/**

Reset the edl returns in VTR mode to the first element of the list.

long __stdcall vvwEDLResetToStart(long lChannel);

/**

Returns 0 if successfule else an Error code.

long __stdcall vvwEDLGetEdit (long lChannel, long * lRecordIn, long * lPlayIn, long * lPlayOut, long * lVidEdit, long * lAudEdit, long * lInfEdit, char * sz8CharClipName, char * sz260CharFileName);

// Shared

/**

Returns the millisecond time of the last change in the transfer queue

long __stdcall vvwGetLastChangeXferMs(long lChannel);

/**

Returns the millisecond time of the last change in the current mode (clip or vtr).

long __stdcall vvwGetLastChangeMs(long lChannel);

/**

long __stdcall vvwInsert (long lChannel, char * szClipName, char * szFileName, long lPosition, long lStart, long lEnd, long lVidEdit, long lAudEdit, long lInfEdit, BOOL fRipple);

/**

long __stdcall vvwBlank (long lChannel, char * szClipName, long lStart, long lEnd, long lVidEdit, long lAudEdit, long lInfEdit, BOOL fRipple);

/**

long __stdcall vvwDelete (long lChannel, char * szClipName, long lStart, long lEnd, long lVidEdit, long lAudEdit, long lInfEdit, BOOL fRipple);

/**

long __stdcall vvwTrim (long lChannel, long lPosition, long lStartOffset, long lEndOffset, long lVidEdit, long lAudEdit, long lInfEdit, BOOL fRipple);

// Settings

/**

Returns the supported attributes of a get/set value (gsClipMode, gsTcSource, etc) or –1 for not supported.

long __stdcall vvwValueSupported(long lChannel, long lValueType);

/**

Returns the current setting for a get/set value.

long __stdcall vvwValueGet(long lChannel, long lValueType, long * plMin, long * plMax);

/**

Sets the get/set value to setting.

long __stdcall vvwValueSet(long lChannel, long lValueType, long lSetting);

/**

Sets the get/set value to setting with extended parameters. Please set unused parameters to NULL.

long __stdcall vvwValueSet2(long lChannel, long lValueType, long lSetting, long lStart, long lEnd, long lVidChan, long lAudChan, long lInfChan);

/**

Calls ValueXXX with gsClipMode. If equal to 1 then the channel is in clip mode, if 0 the channel is in VTR mode.

long __stdcall vvwGetClipMode(long lChannel);

/**

Calls ValueXXX with gsClipMode. If equal to 1 then the channel is in clip mode, if 0 the channel is in VTR mode.

long __stdcall vvwSetClipMode(long lChannel, long lSetting);

/**

Calls ValueXXX with gsTcType (drop frame, non drop frame, pal).

#TC2_TCTYPE_FILM, #TC2_TCTYPE_NDF, #TC2_TCTYPE_DF, #TC2_TCTYPE_PAL, #TC2_TCTYPE_50, #TC2_TCTYPE_5994, #TC2_TCTYPE_60, #TC2_TCTYPE_NTSCFILM, #TC2_TCTYPE_2398, #TC2_TCTYPE_100

long __stdcall vvwGetTCType(long lChannel);

/**

Calls ValueXXX with gsTcType (drop frame, non drop frame, pal).

#TC2_TCTYPE_FILM, #TC2_TCTYPE_NDF, #TC2_TCTYPE_DF, #TC2_TCTYPE_PAL, #TC2_TCTYPE_50, #TC2_TCTYPE_5994, #TC2_TCTYPE_60, #TC2_TCTYPE_NTSCFILM, #TC2_TCTYPE_2398, #TC2_TCTYPE_100

long __stdcall vvwSetTCType(long lChannel, long lSetting);

/**

Calls ValueXXX with gsTcSource (VITC, LTC, Control, Clip).

#GS_TCSOURCE_LTC, #GS_TCSOURCE_VITC, #GS_TCSOURCE_CTL or #GS_TCSOURCE_CLIP

long __stdcall vvwGetTCSource(long lChannel);

/**

Calls ValueXXX with gsTcSource (VITC, LTC, Control, Clip).

#GS_TCSOURCE_LTC, #GS_TCSOURCE_VITC, #GS_TCSOURCE_CTL or #GS_TCSOURCE_CLIP

long __stdcall vvwSetTCSource(long lChannel, long lSetting);

/**

Calls ValueXXX with gsAutoMode. Required for play lists, deferred commands and auto edit commands on VTRs.

long __stdcall vvwGetAutoMode(long lChannel);

/**

Calls ValueXXX with gsAutoMode. Required for play lists, deferred commands and auto edit commands on VTRs.

long __stdcall vvwSetAutoMode(long lChannel, long lSetting);

/**

ADD FUNCTIONS lVidEdit, lAudEdit, lInfEdit

Returns the supported audio, video and info presets for a channel.

long __stdcall vvwGetAvailablePresets(long lChannel, long * plVidEdit, long * plAudEdit, long * plInfEdit);

/**

ADD FUNCTION lAudIn

Get the current audio input.

#GS_AUDSELECT_UNBALANCED_10 #GS_AUDSELECT_UNBALANCED_4

#GS_AUDSELECT_BALANCED_10 #GS_AUDSELECT_BALANCED_4 #GS_AUDSELECT_SPDIF #GS_AUDSELECT_AES_EBU

#GS_AUDSELECT_EMBEDDED

long __stdcall vvwGetAudioInput(long lChannel);

/**

ADD FUNCTION lAudIn

Set the current audio input.

#GS_AUDSELECT_UNBALANCED_10 #GS_AUDSELECT_UNBALANCED_4

#GS_AUDSELECT_BALANCED_10 #GS_AUDSELECT_BALANCED_4 #GS_AUDSELECT_SPDIF #GS_AUDSELECT_AES_EBU

#GS_AUDSELECT_EMBEDDED

long __stdcall vvwSetAudioInput(long lChannel, long lSetting);

/**

Get the current audio input level

long __stdcall vvwGetAudioInputLevel(long lChannel);

/**

Get the current audio input level

long __stdcall vvwSetAudioInputLevel(long lChannel, long lSetting);

/**

Get the current audio Output – See Get/SetAudioInput

#GS_AUDSELECT_UNBALANCED_10 #GS_AUDSELECT_UNBALANCED_4

#GS_AUDSELECT_BALANCED_10 #GS_AUDSELECT_BALANCED_4 #GS_AUDSELECT_SPDIF #GS_AUDSELECT_AES_EBU

#GS_AUDSELECT_EMBEDDED

long __stdcall vvwGetAudioOutput(long lChannel);

/**

Set the current audio Output – See Get/SetAudioInput

#GS_AUDSELECT_UNBALANCED_10 #GS_AUDSELECT_UNBALANCED_4

#GS_AUDSELECT_BALANCED_10 #GS_AUDSELECT_BALANCED_4 #GS_AUDSELECT_SPDIF #GS_AUDSELECT_AES_EBU

#GS_AUDSELECT_EMBEDDED

long __stdcall vvwSetAudioOutput(long lChannel, long lSetting);

/**

Get the current audio output level.

long __stdcall vvwGetAudioOutputLevel(long lChannel);

/**

Get the current audio output level.

long __stdcall vvwSetAudioOutputLevel(long lChannel, long lSetting);

/**

Returns the RMS and Peak audio levels of the input (stop/record) or output (play/pause).

long __stdcall vvwGetAudioPeakRMS(long lChannel, long lAudEdit, long * plPeaks);

/**

Get the current video input.

#GS_VIDSELECT_COMPOSITE, #GS_VIDSELECT_COMPOSITE_2, #GS_VIDSELECT_SVIDEO,

#GS_VIDSELECT_COMPONENT_YUV, #GS_VIDSELECT_COMPONENT_YUV_M2, #GS_VIDSELECT_COMPONENT_YUV_SMPTE, #GS_VIDSELECT_COMPONENT_RGB,

#GS_VIDSELECT_D1_SERIAL, #GS_VIDSELECT_D1_PARALLEL, #GS_VIDSELECT_SDTI, #GS_VIDSELECT_NONE

long __stdcall vvwGetVideoInput(long lChannel);

/**

Set the current video input.

#GS_VIDSELECT_COMPOSITE, #GS_VIDSELECT_COMPOSITE_2, #GS_VIDSELECT_SVIDEO,

#GS_VIDSELECT_COMPONENT_YUV, #GS_VIDSELECT_COMPONENT_YUV_M2, #GS_VIDSELECT_COMPONENT_YUV_SMPTE, #GS_VIDSELECT_COMPONENT_RGB,

#GS_VIDSELECT_D1_SERIAL, #GS_VIDSELECT_D1_PARALLEL, #GS_VIDSELECT_SDTI, #GS_VIDSELECT_NONE

long __stdcall vvwSetVideoInput(long lChannel, long lSetting);

/**

Get the current video output. See Get/SetVideoInput for settings.

#GS_VIDSELECT_COMPOSITE, #GS_VIDSELECT_COMPOSITE_2, #GS_VIDSELECT_SVIDEO,

#GS_VIDSELECT_COMPONENT_YUV, #GS_VIDSELECT_COMPONENT_YUV_M2, #GS_VIDSELECT_COMPONENT_YUV_SMPTE, #GS_VIDSELECT_COMPONENT_RGB,

#GS_VIDSELECT_D1_SERIAL, #GS_VIDSELECT_D1_PARALLEL, #GS_VIDSELECT_SDTI, #GS_VIDSELECT_NONE

long __stdcall vvwGetVideoOutput(long lChannel);

/**

Set the current video output. See Get/SetVideoInput for settings.

#GS_VIDSELECT_COMPOSITE, #GS_VIDSELECT_COMPOSITE_2, #GS_VIDSELECT_SVIDEO,

#GS_VIDSELECT_COMPONENT_YUV, #GS_VIDSELECT_COMPONENT_YUV_M2, #GS_VIDSELECT_COMPONENT_YUV_SMPTE, #GS_VIDSELECT_COMPONENT_RGB,

#GS_VIDSELECT_D1_SERIAL, #GS_VIDSELECT_D1_PARALLEL, #GS_VIDSELECT_SDTI, #GS_VIDSELECT_NONE

long __stdcall vvwSetVideoOutput(long lChannel, long lSetting);

/**

Get the current video input’s ‘Setup’ TBC setting.

long __stdcall vvwGetVideoInputSetup(long lChannel);

/**

Set the current video input’s ‘Setup’ TBC setting.

long __stdcall vvwSetVideoInputSetup(long lChannel, long lSetting);

/**

Get the current video input’s ‘Video’ TBC setting.

long __stdcall vvwGetVideoInputVideo(long lChannel);

/**

Set the current video input’s ‘Video’ TBC setting.

long __stdcall vvwSetVideoInputVideo(long lChannel, long lSetting);

/**

Get the current video input’s ‘Hue’ TBC setting.

long __stdcall vvwGetVideoInputHue(long lChannel);

/**

Set the current video input’s ‘Hue’ TBC setting.

long __stdcall vvwSetVideoInputHue(long lChannel, long lSetting);

/**

Get the current video input’s ‘Chroma’ TBC setting.

long __stdcall vvwGetVideoInputChroma(long lChannel);

/**

Set the current video input’s ‘Chroma’ TBC setting.

long __stdcall vvwSetVideoInputChroma(long lChannel, long lSetting);

/**

Get the current global TBC’s ‘Setup’ setting.

long __stdcall vvwGetVideoTBCSetup(long lChannel);

/**

Set the current global TBC’s ‘Setup’ setting.

long __stdcall vvwSetVideoTBCSetup(long lChannel, long lSetting);

/**

Get the current global TBC’s ‘Video’ setting.

long __stdcall vvwGetVideoTBCVideo(long lChannel);

/**

Set the current global TBC’s ‘Video’ setting.

long __stdcall vvwSetVideoTBCVideo(long lChannel, long lSetting);

/**

Get the current global TBC’s ‘Hue’ setting.

long __stdcall vvwGetVideoTBCHue(long lChannel);

/**

Set the current global TBC’s ‘Hue’ setting.

long __stdcall vvwSetVideoTBCHue(long lChannel, long lSetting);

/**

Get the current global TBC’s ‘Chroma’ setting.

long __stdcall vvwGetVideoTBCChroma(long lChannel);

/**

Set the current global TBC’s ‘Chroma’ setting.

long __stdcall vvwSetVideoTBCChroma(long lChannel, long lSetting);

/**

Turn the house/reference lock on or off

long __stdcall vvwGetVideoGenlock(long lChannel);

/**

Turn the house/reference lock on or off

long __stdcall vvwSetVideoGenlock(long lChannel, long lSetting);

/**

Set the genlock source to input or external reference

long __stdcall vvwGetVideoGenlockSource(long lChannel);

/**

Set the genlock source to input or external reference

long __stdcall vvwSetVideoGenlockSource(long lChannel, long lSetting);

/**

Get the current compression rate

long __stdcall vvwGetCompressionRate(long lChannel);

/**

Set the current compression rate

long __stdcall vvwSetCompressionRate(long lChannel, long lSetting);

/**

Get the status of the super imposed time code overlay

long __stdcall vvwGetSuperImpose(long lChannel);

/**

Set the status of the super imposed time code overlay

long __stdcall vvwSetSuperImpose(long lChannel, long lSetting);

/**

Get the ms time the last error was added to the error log

long __stdcall vvwGetErrorLogMs();

/**

Set the error log pointer to the message you want

long __stdcall vvwSetErrorLog(long lSetting);

/**

Get the length of the current error string

long __stdcall vvwGetErrorLength(long * plLastError, long * plErrorLength);

/**

Get the current error. Sets pointer to the next one automatically

long __stdcall vvwGetError(long * plLastError, long * plSeverity, char * szError);

/**

Returns the total number of frames of storage available at current compression rate if the storage space was empty.

long __stdcall vvwGetTotalTime(long lChannel);

/**

Returns the remaining number of frames of storage available at current compression rate.

long __stdcall vvwGetFreeTime(long lChannel);

/**

Returns the total storage connected in megabytes.

long __stdcall vvwGetTotalStorage(long lChannel);

/**

Returns the amount of available storage for recording in megabytes.

long __stdcall vvwGetFreeStorage(long lChannel);

/**

Get the current millisecond time.

long __stdcall vvwGetCurMs(long lChannel);

/**

Get the available commands for a channel.

long __stdcall vvwGetChannelCapabilities(long lChannel);

/**

Returns the version string of the VVW subsystem.

char * __stdcall vvwGetVVWVersion();

/**

Returns the version string of the MediaReactor subsystem.

char * __stdcall vvwGetMRVersion();

/**

Returns the type string of the VVW channel.

char * __stdcall vvwGetVVWType(long lChannel);

/**

Get the name of a picon file from the media file's name

long __stdcall vvwGetPiconName(char * szFileName);

// Utility

/**

Free a string value returned by the channel.

void __stdcall vvwFreeString(char * szString);

Appendix IV – MediaCmdNet.h

Now available for Linux and Win32 as share library/DLL.

VVW Interface Specification

Contents

Introduction

Components

References

Interface

JAVA

Channel Control

EnableChannels

GetMaxChannels

SetCurChannel

GetCurChannel

GetCurChannelName

Long vvwGetChannelName(long lChannel, char * szChanName)

GetCurChannelType

long vvwGetChannelType (long lChannel)

ShowConfigDialog

Network Specific

Connect

Disconnect

Transport Operations

Play

PlayAtSpeed

PlayFromTo

LoadClip

PlayClip

PlayClipFromTo

FastFoward

FastRewind

Pause

Seek

SeekRelative

Stop

Record

RecordFromTo

RecordStop (prepare record)

SetRecordPresets

Eject

Special Commands

Transfer

Status Operation

UpdateStatus

GetState

GetFlags

GetSpeed

GetPosition

GetLastMs

GetStart

GetEnd

GetClipName

GetFileName

GetCurTC

GetCurState

Media Operations

Clip Mode Operations

GetNextClip

GetClipInfo

GetClipInfoEx

CopyClip

VTR Mode Operations

EDLResetToStart

EDLGetEdit

Shared Operations

GetLastChangeMs

Insert

Blank

Delete

Trim

Settings

ValueSupported

ValueGet

ValueSet

ValueSet2

Settings Format

Base Settings

ClipMode

Get/SetTCType

Get/SetTCSource

Get/SetAutoMode

GetAvailablePresets