Overview
:

Doremi Labs offers
a range of MJPEG ,MPEG and uncompressed high quality video
players and recorders. This MxM allows the control of Doremi
Labs V1 or Doremi Labs Nugget machines.
This type of video recorder/player offers an interesting
alternative to the standard analog video recorders.
The connection between the MXM and the device could be either
a RS422 connection
(Sony 9 Pin connector) or a Network connection (UDP/IP).
In addition to the standard VTR commands, this MXM provides
Clips management
function. Clips are named Segments
in the Doremi V1 litterature (which is more closed to what
a clip is, inside a V1) for single file machines and are
named Files for multi files machines.
Single file machines are seems as a 24h virtual tape machine
like a VTR whereas multiple files machines are seems as
video file servers (multiple 24h virtual tape). In this
last case, each file has a name (Clip name) composed by
a maximum of 8 caracters.
In a single file machine a clip
is a reference to a Timecode In and a Timecode Out position
in the video contents (virtual tape). An important feature
of clips in addition to "save" portions of video
into memories,
is to be able to link these clips in between seamless (back
to back) and to create loops with them. NOTE : When clips
are used, positack feature inside timelines is not relevant
and cannot be used.
In a multi files machine, a clip is a file name combined
with a Timecode In and a Timecode Out information. This
means that multiple Clips can reference the same file but
with different Timecode In and Timecode Out.
The MXM remains compatible
with previous version of the V1 (single file), therefore
some commands and variables have different behavior and/or
meaning if the controlled device is a previous V1 (single
file) or a new V1/Nugget (multi files). Those differences
are explained in detail below.
IMPORTANT : To be able to support multi files machines,
'Clip ID' has been changed to 'Clip Name' but if the machine
is a single file one, the Clip Name MUST be a numeric ID
(1 to 2047) otherwize commands using Clip Name will fail.
Synchronisation consideration
:
In order to synchronize (frame accurate) two or more V1
(or Nugget), devices must have the same clock to garanty
playback synch. The first device should be in "Internal
Sync" synchronisation mode when others devices should
be in "Synch In" synchronisation
mode.
To do ina V1 machine, go into the Main menu, item "Sync
from" (N°2) and select appropiate synchronisation
mode (i.e "Internal Synch for the first device, "Synch
In" for others).
Device
wiring :
When the device is used
with a serial connection, the following wiring diagram could
be used :



> Top
Installation
(MXM) :
No special installation required.
> Top
Creation
(Device) :
Device
Creation Window :
.gif)
When
Serial Port Connection is used :
COM Port :
Com port number used to communicate with
the device.
When Network Connection is used :
IP Address :
IP Address used to communicate with the device.
Channel :
Channel of the player/recorder inside the device. This is
used when the V1 has 2 or more channels (player/recorder).
Start Time Code :
Timecode value of the first available
image on the Device. This value is used for positrack purpose.
Fields per Frame:
Indicate the number of fields use per
frame. This value must be set in accordance with the menu
settings of the V1. In case of this menu is not available
(for instance new firmware version 4.x), LCD display indicates
F1/F2 when playback if two fields per frame mode is used.
> Top
Commands
(List Of) :
Stop :
Description :
Stop the device currently in play mode or record mode.
Parameters : no parameter.
Play :
Description :
Start playing video.
Parameters : no parameter.
Usage :
This command start playing from the current position to
the end of video contents. When clips are pending in the
PendingClipList then the playback continue until the last
clip is played.
Record :
Description :
Start recording video.
Parameters : no parameter.
Usage :
The device must be configured to accept this command.
In certain case the record capability of the device is
disabled to increase best response time in play mode.
Step Forward :
Description :
Set the device position to the next frame (image) refering
to the current position. If the device is playing, it
will cause playing stop.
Parameters : no parameter.
Step Reverse :
Description :
Set the device position to the previous frame (image)
refering to the current position. If the device is playing,
it will cause playing stop.
Parameters :
no parameter.
Fast Forward :
Description :
Perform a fast forward play on the device at the maximum
speed.
Parameters : no parameter.
Fast Reverse :
Description :
Perform a fast reverse play on the device at the maximum
speed.
Parameters : no parameter.
Locate :
Description :
Set the device time position to the specified position.
Parameters :
TimeCode : [Type : Time] : Time
position to go to.
Variable Speed :
Description :
Cause the device to play in variable speed, forward or
reverse.
Parameters :
Mode : [Type : Enum] : Variable
speed mode.
Availables values
:
"Var" : Basic variable speed.
"Shuttle" : Shuttle variable speed.
"Jog" : Jog variable speed.
"Program Play" Program Play variable
speed.
Speed
: [Type : Integer] : Percent of speed. This value could
be negative (reverse play) or positive (forward play).
For example a value of 50% start playing in forward direction
at 1/2 normal speed, a value of 200% start playing in
forward direction at 2x normal speed and a value of -200%
start playing in reverse direction at
2x normal speed.
Set Edit Mode :
Description :
Selection the edit mode of the device.
Parameters :
Mode : [Type : Enum] : Insert mode.
Availables values
:
"Insert" : Insert Mode.
"Assemble" : Assemble Mode.
Video : [Type : Enum] : Select
or de-select video edition.
Availables values
:
"Off" : Video not concerned.
"On" : Video concerned.
Audio1 : [Type : Enum] : Select
or de-select audio 1 edition.
Availables values
:
"Off" : Audio 1 not concerned.
"On" : Audio 1 concerned.
Audio2 : [Type : Enum] : Select or de-select audio 2 edition.
Availables values
:
"Off" : Audio 2 not concerned.
"On" : Audio 2 concerned.
TC : [Type : Enum] : Select or de-select timecode edition.
Availables values
:
"Off" : Timecode not concerned.
"On" : Timecode concerned.
Edit :
Description :
Enter or leave edit mode.
Parameters :
Command : [Type : Enum] : Command value.
Availables values
:
"Off" : Enter Edit mode.
"On" : Leave Edit mode.
Set TC Generator :
Description :
Select the start timecode value for the internal timecode
generator.
Parameters :
TimeCode : [Type : Time] : Timecode
value.
Set Start Timecode :
Description :
Change the timecode of the first availabe frame (image)
on the device.
Parameters :
TimeCode : [Type : Time] : Timecode value.
Create Clip :
Description :
Create or modify a Clip in the V1 (if the clip already
exists, it is loaded for record).
Parameters :
Clip Name
: [Type : String] : Name of clip to be created or modified.
If the device is a single file machine, this value is
in range from 1 to 2047 otherwize if the device is a
multi files machine this value is a name composed with
max 8 caracters.
In Time : [Type : Time] : Timecode
in position for the clip.
Out Time : [Type : Time] : Timecode
out position for the clip.
Usage :
If the clip name does not exist then it is created else
the clip parameter (In Time and Out Time) are changed.
Rem :
In a single file machine, if a timecode offset has been
defined (i.e. using OPTION+IN Keys), current timecode
position must be at least after the timecode offset
value to allows clip creation.
In a multi files machine each file is considered as virtual
24h video tape, so before In Time and after Out Time
video is black.
Delete Clip :
Description :
Delete a Clip from the V1.
Parameters :
Clip
Name : [Type : String]
: Name of clip to be deleted. If the device is a single
file machine, this value is in range from 1 to 2047
otherwize if the device is a multi files machine this
value is a name composed with max 8 caracters.
Usage :
In
a single file machine, deleting
a clip does NOT mean that the video contents will be
erased. Only the clip references (In Time, Out Time
and Link attributes) will be erased.
In a multi files machine video material will be erased.
Load Clip :
Description :
Load a Clip.
Parameters :
Clip Name
: [Type : String] : Name of clip to playback. If the
device is a single file machine, this value is in range
from 1 to 2047 otherwize if the device is a multi files
machine this value is a name composed with max 8 caracters.
In Time
: [Type : Time] : Timecode in position for the clip. This parameter has no effect on single file machines.
Out Time
: [Type : Time] : Timecode out position for the clip. This parameter has no effect on single file machines.
Auto Play : [Type : Enum] : Enable
to start playing directly after loading completed.
Availables values
:
"Off" : Device wait for Play command.
"On" : Device start to play after
load.
Usage
: In
a multi file machine, LoadClip
command reset all pending Clips and stop playback.
Link Clip :
Description :
Created a link between two clips in the V1.
Parameters :
Clip Name
: [Type : String] : Name of clip to be linked. If the
device is a single file machine, this value is in range
from 1 to 2047 otherwize if the device is a multi files
machine this value is a name composed with max 8 caracters.
To Clip Name
: [Type : String] : Name of clip to ne linked to. If
the device is a single file machine, this value is in
range from 1 to 2047 otherwize if the device is a multi files
machine this value is a name composed with max 8 caracters.
Usage :
In
a single file machine, linking
two clips will cause the playback to swap from the first
clip to the second clip seamless (back to back) when
the first clip reach the end.
If both Clip IDs are the same then a loop on the given
clip is created.
To create a loop between severals clips a link must
be down before each clip as well as between the last
clip and the first one. Ex Link 1->2 + Link 2->3
+ Link 3->1 will create a loop including clips 1,
2 and 3.
In a multi files machine, the 'To Clip Name' clip is added
to the PendingClipList if the 'Clip Name' does not exist
in the PendingClipList
otherwize it is inserted after the 'Clip Name' clip
in the PendingClipList.
Get Clip Info :
Description
: Retreive attributes from a Clip inthe V1.
Parameters :
Clip Name : [Type : String] : Name of clip to
retreive informations from. If the device is a single
file machine, this value is in range from 1 to 2047
otherwize if the device is a multi files machine this
value is a name composed with max 8 caracters.
Usage : In a single file machine, when this command
is issued, the contents of variables "InTime",
"OutTime", "CurrentClip", "PreviousClip"
and "NextClip" are updated with the clip attributes.
If the given clip name does not exist then the contents
of those variables is set to 0.
In a multi files machine, this command has no effect.
Get Clip List :
Description
: Retreive the list of clip already defined in the
machine.
Parameters : No Parameter.
Usage : In a single file machine, this command
has no effect.
In a multi files machine, this starts the retreiving process.
When the process is finished the ClipList variable is
filled with the list of clips (the ClipCount variable
contains the number of clips in the list).
Load
Next Clip :
Description
: Load the next clip to be played.
Parameters :
Clip Name : [Type : String] : Name of clip to
playback. If the device is a single file machine, this
value is in range from 1 to 2047 otherwize if the device
is a multi files machine this value is a name composed
with max 8 caracters.
In Time : [Type : Time] : Timecode in
position for the clip.
Out Time : [Type : Time] : Timecode out position
for the clip.
Usage :
In
a single file machine, this
command has no effect.
In
a multi files machine, this
add a new clip in the PendingClipList. When a play is
ussued, the current clip is played then the clips into
the PendingClipList are played.
Skip
Current Clip :
Description
: Skip the current played clip.
Parameters : No Parameter
Usage :
In
a single file machine, this
command has no effect.
In
a multi files machine, this
command force the current played clip to reach its Timecode
out position. If a clip is pending in the Pending Clip
List then the next clip starts playing.
> Top
Variables
(List Of) :
TimeCode :
Type :
Time.
Description : Current time position of the device.
CurrentStatus:
Type :
Enum.
Description : Current status of the device.
Available Values :
"No disk" : Device
disk is not mounted or not present.
"Tension release" : Should never
be used. This is maintains for compatibility with Sony
RS422 protocol.
"Stop" : The device is in stop mode.
"Still" : The device is in still
mode (same state as Stop).
"Play" : The device is playing.
"Record" : The device is recording.
"Forward" : The device is in fast
forward play.
"Rewind" : The device is in fast
rewind play.
"Locate" : The device is performing
a time position.
"Var Speed Still" : The device is
in basic variable speed but at speed 0.
"Var Speed Reverse" : The device is in basic variable speed,
reverse play.
"Var Speed Forward" : The device
is in basic variable speed, forward play.
"Shuttle Speed Still" : The device is in shuttle variable speed
but at speed 0.
"Shuttle Speed Reverse" : The device
is in shuttle variable speed, reverse play.
"Shuttle Speed Forward" : The device is in shuttle variable
speed, forward play.
"Jog Speed Still" : The device is
in jog variable speed but at speed 0.
"Jog Speed Reverse" : The device is in jog variable speed,
reverse play.
"Jog Speed Forward" : The device
is in jog variable speed, forward play.
"Program Play Reverse" : The device is in program reverse play.
"Program Play Forward" : The device
is in program forward play.
CurrentError :
Type :
Enum.
Description : Last occured error.
Available Values :
"No Error" : No error.
"Command Error" : The last command could not be completed due
to unacceptable in this state or not supported.
"Not Online" : The device don't respond, not online.
"Invalid Clip Name" : The given clip name
in invalid or does not exist.
"Unsupported Command" : The command is not
supported with this machine (i.e multi files machine command
on a single file machine).
StartTimeCode :
RemainingTime :
Type
: Time.
Description : Free record space on disk in time (available time for record).
Rem : In
a multi file machine, this variable is
not used.
ActiveDisk
:
Type
: Integer.
Description : Indicate if the device is single file (0) or multi files (1).
Rem : This variable was used in previous version of the MXM to indicate
the current mounted disk Id, but this information is no longer used in the V1 nor Nugget. The variable
name & type has been kept for backward compatibility.
InTime
:
Type :
Time.
Description : In
a single file machine, this
variable indicates the timecode In of the clip which Name is in variable the "CurrentClip".
In
a multi files file machine, this
variable indicates the timecode In of the clip which Name is in variable the "CurrentClipName".
OutTime
:
Type :
Time.
Description : In
a single file machine, this
variable indicates the timecode Out of the clip which Name is in variable the "CurrentClip".
In
a multi files file machine, this
variable indicates the timecode Out of the clip which Name is in variable the "CurrentClipName".
CurrentClip
:
PreviousClip
:
NextClip
:
Type
: Integer.
Description : Numeric name of the clip forward linked with the
clip ID in "CurrentClip" variable. This value
is updated after each clip management command. After
a LinkClip command these value should reflect the parameter
"To Clip ID" of this command.
In a multi files machine, this variable is not used.
CurrentClipName
:
Type
: String.
Description : Name of the current loaded clip.
This value is updated after each clip management command.
After a LoadClip command these value reflect the parameter
"Clip Name" of this command.
When PendingClipList is not empty, this variable is
automatically updated during playback to reflect the
current played file.
In a single file machine, this variable is not used.
ClipList
:
ClipCount
:
PendingClipList
:
PendingClipCount
:
> Top
Support
(Difference with previous versions) :
V 1.0.1:
- Added: Support for Showmaster.
V 1.0.2:
- Bug Fixed: a false "Serial Port Error" is reported when loading a project under Showmaster (if serial port is used by the device).
V 1.0.3:
- Added: Support for Showmaster Pro.
> Top
|