Oxtel Series Automation Protocol 01035-15 May 2009 Miranda Technologies Inc. UK Tel: +44 (0) 1491 820000 Fax: +44 (0) 1491 820001 Email: uksales@miranda.com Web: www.miranda.com f Software: http://www.miranda.com/portal/downloads.
Preface Automation Protocol Copyright © 1999-2009 Miranda Technologies Inc.. All rights are reserved and, under the copyright laws, this manual may not be reproduced in any form, in whole or in part, without the prior written consent of Miranda Technologies Inc.. Printed in the UK. Page 2 Miranda Technologies Inc.
Preface Automation Protocol Preface Warranty Miranda Technologies Inc. offer a 24 months free parts and labour warranty on Oxtel Series equipment from the date of the initial invoice, providing there is no evidence of negligence, abuse or failure to reasonably follow instructions given by the Company for its proper use. During the warranty period, Miranda Technologies Inc. will replace or repair at its cost, Oxtel Series equipment returned to the factory, carriage and duty paid and insured by the sender.
Preface Automation Protocol Associated Publications Description Presmaster Automation Protocol Imagestore User Manual Imagestore 3 & 2U User Manual Imagestore HD-TV User Manual Imagestore 300 User Manual Imagestore Intuition+ User Manual Imagestore 300+ User Manual Imagestore 750 User Manual LGK-3901/DSK-3901 User Guide Part number 01235 02359 02954 02901 03402 03457 03753 M872-9900 M887-9900 Page 4 Miranda Technologies Ltd
Preface Automation Protocol Contacts For technical assistance, please contact your nearest Miranda Technical Support centre: Americas (9:00am - 9:00pm EST) Telephone +1-800-224-7882 Fax: +1-514-335-1614 techsupp@miranda.com Europe, Middle East, Africa, UK (9:00am - 6:00pm GMT) Telephone +44 (0) 1491 820222 Fax: +44 (0) 1491 820002 eurotech@miranda.com France (9:00am - 5:00pm GMT+1) Telephone +33 1 55 86 87 88 Fax: +33 1 55 86 00 29 eurotech@miranda.
Preface Automation Protocol Page 6 Miranda Technologies Ltd
Automation Protocol Table of Contents Table of Contents Preface 3 Warranty --------------------------------------------------------------------------- 3 Associated Publications -------------------------------------------------------- 4 Contacts ---------------------------------------------------------------------------- 5 Table of Contents Introduction 7 21 Applicability---------------------------------------------------------------------- 21 Overview -------------------------------------------------
Automation Protocol Table of Contents STX0 / STX1-------------------------------------------------------------------27 ACK / NAK ---------------------------------------------------------------------28 Command Terminator -------------------------------------------------------28 Command Separator --------------------------------------------------------28 Status Responses ------------------------------------------------------------28 Unsolicited Messages (Tallies)--------------------------------------------2
Automation Protocol Table of Contents Save Image to Library 9 ------------------------------------------------- 42 File Save Masked I ------------------------------------------------------- 42 Enquire File Status P----------------------------------------------------- 43 Erase File Q ---------------------------------------------------------------- 43 Load / Unload Live Video H -------------------------------------------- 43 Grab Fill/B+KEY to the Preview Store J ----------------------------- 44 Erase Store
Automation Protocol Table of Contents Fade-To-Black State Tally Yf -------------------------------------------72 Text Crawl Count Tally Yg-----------------------------------------------72 Animation/Clip Cycle Tally Yj -------------------------------------------73 Keyer Position Tally 3----------------------------------------------------74 Audio Commands (old) 75 Audio Commands Table ------------------------------------------------------76 Matrix Input Preselect a ---------------------------------------
Automation Protocol Table of Contents Image Load Mode Rm --------------------------------------------------- 95 Validate Template RA---------------------------------------------------- 96 Get Audio File Duration RB--------------------------------------------- 97 Animation Commands 99 Start Animation S0 ------------------------------------------------------- 99 Stop Animation S1 ------------------------------------------------------- 99 Select Animation Frame S2 -----------------------------------------
Automation Protocol Squeezy Commands Table of Contents 115 Set Squeeze Preset W0------------------------------------------------ 115 Select Squeeze Configuration W1----------------------------------- 116 Run Squeeze Move W2 ------------------------------------------------ 117 Select Move Profile W3 ------------------------------------------------ 117 Select Preset Borders W4 -------------------------------------------- 118 Enquire Preset W5 ------------------------------------------------------ 118 2D/
Automation Protocol Table of Contents GPI Output Status XB---------------------------------------------------136 Serial Baud Rate XC ----------------------------------------------------137 Time Code Source XE --------------------------------------------------138 Set Preview XH-----------------------------------------------------------139 Set Reference XI ---------------------------------------------------------140 Clock Offset XJ -----------------------------------------------------------141 Get Serial Nu
Automation Protocol Table of Contents Voice-Overs j2 ------------------------------------------------------------ 167 Duck Preset j2 0---------------------------------------------------------- 169 Voice-over Preset j2 1 -------------------------------------------------- 169 Voice-over Level j2 2---------------------------------------------------- 170 Rates j3 ------------------------------------------------------------------ 170 Fade to/from Silence j30 -------------------------------------------- 171 Fad
Automation Protocol Table of Contents Audio AB Position ja-----------------------------------------------------190 Audio AB Mix Mode jb --------------------------------------------------190 Audio AB Asymmetric Transition jc ---------------------------------190 Audio AB Fade to Position jd------------------------------------------191 Audio A and B Fade Position je & jf ---------------------------------191 Set Audio Input Shuffles jg---------------------------------------------191 Audio Clean Feed Select jh
Automation Protocol Table of Contents Set Program Down-Mix Lo/Ro Centre Mix oG -------------------- 205 Set Program Down-Mix Lo/Ro Surround Mix Level oH -------- 206 TM Set Program Dolby Surround EX Mode oI ---------------------- 206 Set Program Dolby Headphone Mode oJ-------------------------- 207 Set Program A/D Converter Type oK ------------------------------- 207 Set Program High Pass Filter Enable oL--------------------------- 208 Set Program Low Pass Filter Enable oM -------------------------- 209 S
Automation Protocol Table of Contents Setting Template background options ZD-------------------------226 Text Straps ---------------------------------------------------------------------227 Run Strap Z5 -------------------------------------------------------------227 Set Strap Speed ZC ----------------------------------------------------227 Enquire Crawl Count Loop Zc----------------------------------------228 Text Box Update Zd -----------------------------------------------------229 Image Update Ze-----
Automation Protocol Table of Contents EAS On n1 -------------------------------------------------------------- 245 EAS Off n2 -------------------------------------------------------------- 245 EAS Set Text n3 --------------------------------------------------------- 245 EAS Set Priority n4 ----------------------------------------------------- 246 Passive Mode Commands 247 Set Passive Mode On/Off Ya ----------------------------------------- 247 Set Passive Mode Transmission Interval Yb------------------
Automation Protocol Table of Contents Imagestore Upstream------------------------------------------------------269 Imagestore 300[+] & Imagestore HD-TV ------------------------------269 Intuition[+]---------------------------------------------------------------------269 Imagestore 750--------------------------------------------------------------269 LGK-3901 ---------------------------------------------------------------------270 DSK-3901---------------------------------------------------------------------
Automation Protocol Miranda Technologies Ltd Table of Contents Page 20
Automation Protocol Introduction Introduction Applicability This user guide describes the automation control protocol used by Miranda Technologies Inc. Oxtel range of broadcast products. The Oxtel series products that can be controlled using this protocol include: • • • • • • • • • • • • • • Imagestore 2 Imagestore 2U Imagestore 3 Imagestore HD-TV Imagestore 300 Imagestore 300+ Intuition SD Intuition HD Intuition SD+ Intuition HD+ Imagestore 750 Intuition XG LGK-3901 DSK-3901 (v2.25) (v2.25) (v2.
Automation Protocol Introduction Overview The Oxtel unit takes the role of the controlled device, while the automation system is the controller. Automation commands are sent to the Oxtel unit from the controller, and the Oxtel unit actions these commands returning status information as requested. With RS232 or RS422 communications, the link between a controlled device and its controller is point-to-point (a single physical connection between the two). With later Imagestore products (IS2/2U/3 v2.
Automation Protocol Interconnections Interconnections Automation control of Oxtel products uses RS232 or RS422 asynchronous serial communications. All Imagestore units have two or more connectors with one being RS232, and another being RS422 (point-to-point). The connectors on later Imagestore products, for example Imagestore 750, LGK-3901 and DSK-3901 are configurable to different serial types including RS232 and RS422. Set up of serial ports (i.e.
Automation Protocol Interconnections Pin 2 Function RX 3 5 TX GND All other pins are not used and must be unconnected. RS422 The RS422 pin-out is a 9-way male D-type with the following pin-out: Pin Function 1 TX - 2 TX + 3 RX + 4 RX - 5 GND All other pins are not used and must be unconnected. Note: For Imagestore 2-based products and earlier the RS422 pin-out does NOT conform to the broadcast industry standard commonly known as “Sony 9-pin”.
Automation Protocol Data Link Layer Data Link Layer Serial Data Layout 1 start bit, 8 data bits, 1 stop bit. No parity bit. Data Transfer Rate Baud rates of 9600, 19200, 38400, 57600, 115200 can be selected for any RS232 or RS422 serial port. For some much older units, the data rate for communication is 19200 baud irrespective of interface standard. Please refer to individual User Manuals for details.
Automation Protocol Data Link Layer CRC Generation The CRC (Cyclic Redundancy Check) bytes provide a means of verifying the transmission and receipt of incoming packets. A 16-bit CRC value should be generated (by Automation) using the contents of the corresponding transmission packet. The resultant value is appended to the data packet and transmitted to the Oxtel unit as two 8-bit bytes.
Automation Protocol Transport Layer Transport Layer RS232/RS422 Point-to-Point Packet Flow Command List For transmission over point-to-point links, the command list is encapsulated in packets as described below: Field Byte 0 Byte 1..n-1 Contents STX0/1 Command List Byte n Command Terminator ‘:’ Byte n+1 Byte n+2 CRC low CRC high STX0 / STX1 Oxtel units expect the STX values in successive packets that are transmitted by Automation to alternate between STX0 and STX1.
Automation Protocol Transport Layer ACK / NAK If the STX is wrong then neither ACK nor NAK is returned and Automation will have to deal with a time-out. If the STX was correct but the CRC wrong, then a NAK is sent back to Automation by the Oxtel unit If both the STX and CRC are correct for a packet then an ACK0 or ACK1 character (corresponding to the STX) is sent back to Automation.
Automation Protocol Transport Layer As the STX of the response matches the STX of the command, sending a command list containing multiple status requests will cause multiple responses with identical STX bytes. Unsolicited Messages (Tallies)1 Unlike status replies, which are only returned in response to particular commands, unsolicited messages can be sent by the Imagestore at any point based on changes in state. Unsolicited messages are distinguished by the leading STX2 byte. Field Byte 0 Byte 1..
Automation Protocol Miranda Technologies Ltd TCP/IP-Based Automation Page 30
Automation Protocol TCP/IP-Based Automation TCP/IP-Based Automation Serial Automation Most Oxtel products2 have the ability to run automation protocols over a standard TCP/IP socket interface, provided the unit is equipped with Ethernet interface. The packet layout and protocols are exactly as described above for RS232/RS422 point-to-point packet flow, including STX and CRC checksum bytes. Connections are accepted on port 5006.
Automation Protocol TCP/IP-Based Automation Command List Field Contents Byte 1..n-1 Command List Byte n Command Terminator ‘:’ Status Response Field Byte 1..n-1 Contents Status Response Byte n Status Terminator ‘:’ Unsolicited Messages Field Contents Byte 1..
Automation Protocol Command List Command List Video Commands Video layer commands are represented by a command list. Although parameter formats do vary, the video layer commands are often formatted with parameters separated by spaces.
Automation Protocol cmd param_1 Command List param_2 param_3 param_n In the above format, cmd is the echoed status enquiry command. The actual number and types of parameters returned is dependent on the command type issued, so please check individual commands for formatting. Extended Commands and Responses These messages have two bytes defining the command, allowing a much wider range of commands. The first byte typically specifies a command group, while the second identifies a sub-command.
Automation Protocol Video Commands Video Commands ID 0 1 2 3 4 5 6 7 8 9 < @ A B C D E F G H I J K L M N O P Q l Y1 Y3 Description Fade to Black / Fade from Black Fade Keyer Up / Fade Keyer Down Cut to Black / Cut from Black Cut Keyer Up / Cut Keyer Down Set Mask Mask Enable / Disable Swap Preview and Main Image using Cut Swap Preview and Main Image using V-fade Load Image from Library Save Image to Library Set Transition Type Set Fader Angle Erase Store Set Transition Duration Set Self Key, Separate Key
Automation Protocol Video Commands Layer Selections The layer parameter passed to many commands can have different meanings depending on the unit being controlled, and its current operating mode. Swap Preview Mode For units in swap/preview mode, where one image is keyed onto the preview output and a second image keyed over the program output, layer selection works like this: • Layer 0 = preview layer • Layer 1 = program layer This allows independent control of both layer outputs.
Automation Protocol Video Commands Transition Commands Fade to Black / Fade from Black 0 These commands cause the total output from the selected keyer layer to be faded to or from black. Repeated commands of the same sort have no effect. If the command is not finished when a reverse instruction is received, the fade will reverse direction and continue at the same rate.
Automation Protocol Video Commands Example: void FadeKeyer(int Layer, bool Up) { remote_send("1%x %d", Layer, Up ? 1:0); } Cut to Black / Cut from Black 2 These commands are identical to an instant fade to / from black. CMD 2 Param_1 Layer No. Param_2 0=To black, 1=From black 2=Cut to/from black Example: void CutToBlack(int Layer, bool Black) { remote_send("2%x %d", Layer, Black ? 0:1); } Cut Keyer Up / Cut Keyer Down 3 These commands are identical to an instant fade in the designated direction.
Automation Protocol Video Commands Swap Preview and Main Image using Cut 6 Note: This command is largely deprecated. Also known as “Cut Swap” This command is only relevant to units used in swap-preview mode. The output is cut down, the preview store is then swapped with the main store and the keyer output is cut back up to maximum. If the main store was faded down prior to this action, then this part of the operation is ignored.
Automation Protocol Video Commands Example: void SetFaderAngle(int Layer, int Type, int Angle) { remote_send("@%x %d %x", Layer, Type, Angle); } Set Transition Duration B This command sets the duration for the selected transaction on the selected layer. In swap-preview mode, the value applies to the main layer, whatever layer is actually selected. The value provided sets the number of fields to complete the action.
Automation Protocol Video Commands Image Commands Older Oxtel Imagestores use numbered images. Newer IS2-based units, Imagestore HD-TV, Imagestore 300, Imagestore 750, LGK-3901 and DSK3901 can use numbered images and can also use named images, with file extensions “.OXT” for stills and “.OXA” for clocks and animations. Imagestore Intuition uses named images with the file extension “.TEM” for templates. Many of the commands listed in this section only work for numbered images.
Automation Protocol Video Commands Save Image to Library 9 Note: This has been superseded by the R1 command. This saves an image in the selected store to the internal library. Images are numbered from 1 to n, where n is dependent on the storage option purchased. The image number is in hexadecimal. CMD Param_1 Param_2 9 Layer No. Image No. (hex) Example: Save image as V123.
Automation Protocol Video Commands Enquire File Status P Note: This has been superseded by the R3 command. This command returns status on the specified file slot. In particular it determines if the file slot is available in the internal image library. Images are numbered from 0 to n, where n is dependent on the storage option purchased. The image number is sent as a hexadecimal value. CMD P Param_1 Image No.
Automation Protocol Video Commands Please note that setting the second parameter as 2 or 3 requires that the Imagestore hardware supports additional external Fill and Key pairs. Example: void LoadLive(int Layer, int Input) { remote_send("H%x %x", Layer, Input); } Grab Fill/B+KEY to the Preview Store J Note: This command is largely deprecated. This command causes a single frame of the fill and key signals present on inputs Fill/B and KEY to be stored into the selected store.
Automation Protocol Video Commands Enquire Loaded Image Status O This command returns a status block about the image loaded onto the selected layer. CMD Param_1 O Layer No.
Automation Protocol Note: Video Commands Unsolicited O command responses on state change can be requested via the YO tally (see page 71).
Automation Protocol Video Commands Input Commands The following Input Port numbers (corresponding to physical SDI inputs) are used for the Input Control commands.
Automation Protocol Force Colour Field Video Commands L This command causes the selected input channel to produce a colour field. The R, G & B values are given as parameters. The values are percentages of saturated colour, for example 0x32, 0x32, 0x32, is 50% red, green and blue. See table at the head of this page for input port numbers. CMD L Param_1 Input Port No. Param_2 Red 0-x64 Param_3 Green 0-x64 Param_4 Blue 0-x64 See table on page 47 for input port numbers.
Automation Protocol Pass SDI Video Commands K This command allows the selected input channel to pass the SDI (if present). If no SDI is present then the colour field will be automatically substituted. CMD Param_1 K Input Port No. See table on page 47 for input port numbers. Example: void PassSDI(int Input) { remote_send("K%x", Input); } Note: For Imagestore 750, LGK-3901 and DKS-3901 black output will be shown when no SDI signal is present.
Automation Protocol Video Commands Masking & Positioning Commands Set Layer Mask 4 Loads the mask registers with the left, right, top, and bottom values defining the size of the mask. In cascade mode, the mask registers of both layers may be loaded, but in swap / preview mode, only the preview layer mask registers may be loaded. The left and right values must be from zero to the width of the image loaded onto the layer specified (measured in pixels).
Automation Protocol Video Commands Example: void MaskEnable(int Layer, bool Enable) { remote_send("5%x %d", Layer, Enable); } Set Image Position G This command sets the position of the image relative to the viewing screen. The origin is the upper left hand corner with positive increments moving the picture downwards and to the right. The units of the ‘horizontal’ and ‘vertical’ values are in pixels and lines respectively. CMD Param_1 Param_2 Param_3 G Layer No.
Automation Protocol Video Commands The status of the image position on each layer can be enquired using: CMD Param_1 G Layer No. Example: void EnquireImagePosition(int Layer) { remote_send("G%x", Layer); } This will return: CMD G Param_1 Layer No. Set Input Masks Param_2 Horizontal Param_3 Vertical l This command sets the input mask for each SDI input of an Imagestore 750. All of the mask parameters are measured in pixels so their range is dependent on the standard.
Automation Protocol Video Commands source (because it has been reset to a colour field or test pattern), the image will not be masked - only the SDI source is masked.
Automation Protocol Video Commands Keyer Control Commands Set Self Key, Separate Key, or No Key C Oxtel series products implement keying where the Key is contained in the luminance content of the SDI signal. The Key source is selected from either the Fill input (known as Self Key) or a separate Key signal. Self key sets the key input associated to a particular keyer layer to be derived from the luminance content (Y value) of the “Fill” signal itself.
Automation Protocol Video Commands Set Key Linear or Full D Full key refers to the standard keying algorithm where the Fill signal needs to be multiplied by the Key signal prior to adding it to the Background signal. The equation for this is: Output = Key x Fill + (1-Key) x Bgnd Linear key is more typically called Additive Keying. This requires the foreground image to be ‘pre-composited’ onto a black matte. The equation for this is: Output = Fill + (1-Key) x Bgnd CMD Param_1 Param_2 D Layer No.
Automation Protocol Video Commands Set Key Normal or Invert E Normal key implies that increasing key values will introduce more of the fill signal. Key invert implies that increasing key values introduce less fill. The Key output is replaced with (1-Key), thereby inverting the action of the Key. CMD Param_1 Param_2 E Layer No.
Automation Protocol Video Commands Example: void SetCGT(int Layer, int C, int G, int T) { remote_send("F%x %x %x %x", Layer, C, G, T); } Note: For optimum results the Clip, Gain and Transparency values should be set to 64, 940 and 512 respectively. The Clip cannot be set to greater than the Gain. For Imagestore 300, Imagestore HD-TV and Imagestore 750, LGK-3901, DSK-3901Clip and Gain values set between 0-63 or 941-1023 are clamped to 64 and 940 respectively.
Automation Protocol Video Commands Miscellaneous Commands Enquire System Status M This command returns information about the system.
Automation Protocol Video Commands Enquire Video Layer Status N This command returns a status block about the video layers.
Automation Protocol Video Commands The information returned for DSK-3901 is: Format Field %c Cmd %03x DSK1 Fader Angle (0x0 to 0x200) %03x DSK1 Fade-to-Black Angle (0x0 to 0x200) %03x DSK2 Fader angle (0x0 to 0x200) %03x DSK2 Fade-to-Black Angle (0x0 to 0x200) %02x 0 (Not used) The information returned for LGK-3901 is: Format Field %c Cmd %03x DSK1 Fader Angle (0x0 to 0x200) %03x DSK1 Fade-to-Black Angle (0x0 to 0x200) %03x DSK2 Fader angle (0x0 to 0x200) %03x DSK2 Fade-to-Black A
Automation Protocol Video Commands The information returned for Imagestore Intuition is: Format Field %c Cmd %03x Layer Fader Angle (0x0 to 0x200) %03x Layer Fade-to-Black Angle (0x0 to 0x200) %03x 0 %03x 0 %02x 0 Fader Angle = 0x0 equates to “Keyer Off” or “FTB On”. Fader Angle = 0x200 (512) equates to “Keyer On” or “FTB Off”. Note: Transition types supported are not consistent between different products, so please check individual user manuals for details.
Automation Protocol Video Commands CMD Y3 Param_1 ABMixer Example: void SetPreviewMixer(int ABMixer) { remote_send("Y3%d", ABMixer); } Select Channel Input UF Note: This command is only valid for LGK-3901 and DSK-3901 This command sets which of the SDI inputs will be shown on the program or preview channel: CMD UF Param_1 %1x: Mixer Input 0 (fixed) Param_2 %1x: Channel 1 – Preview Param_3 %1x: Source 0 – Program In 4 – Fill 2 The current routing can be enquired using: CMD Param_1 Param_2 Y3 %1
Automation Protocol Video Commands Tally Commands The Imagestore can be set into a mode where its state is fed back over automation without explicit request. This information is referred to as unsolicited tallies. Enable Video Tallies Y6 This command enables or disables the Y6, Y9, YA, Yf and 3 video tallies for the serial/network port on which the command was received.
Automation Protocol Video Commands For all Imagestore products except Imagestore Intuition, this “Y61” command returns with: CMD Param1 Param2 Param3 Param4 Param5 Param6 Param7 Y6 %1x AB Mix Position %1x DSK1 Keyer Position %1x DSK 2 Keyer Position %1x DSK 1 FTB Position %1x DSK 2 FTB Position %02x SQZ Preset/ Seq.
Automation Protocol Video Commands For Imagestore 3 and Imagestore 300 fitted with a dual channel 2D/3D DVE the possible Router Modes are: DVE_ROUTER_NONE 0 DVE_ROUTER_MIDGROUND_REVEAL 4 DVE_ROUTER_BYPASS 9 DVE_ROUTER_MIDGROUND_MIX_REVEAL A DVE_ROUTER_IS_MIGROUND_AB B DVE_ROUTER_IS_MIGROUND_BA C DVE_ROUTER_IS_MID_SQZ_A_MID D DVE_ROUTER_IS_MID_SQZ_MID_A E DVE_ROUTER_BEHIND F For Imagestore HD-TV the possible Router Modes are: DVE_ROUTER_NONE 0 DVE_ROUTER_A_B_MIXER DVE_ROUTER_A_AND_B_OVE
Automation Protocol Video Commands The information returned for the Imagestore 2/3, Imagestore 300[+], Imagestore HD-TV and Imagestore 750 is: CMD Param_1 Y6 %1x: Tally Enable 1=Enabled, 0=Disabled The information returned for the LGK-3901 and DSK-3901 is: CMD Param_1 Param_2 Y6 %1x: Tally Enable 1=Enabled, 0=Disabled %1x: Intuition Tally Forward Enable 1=Enabled, 0=Disabled Request Wake-up Packet Y7 This command causes an unsolicited wake-up packet to be returned by an Imagestore.
Automation Protocol Video Commands Enable Audio Tallies Y8 This command enables or disables unsolicited audio tallies for the serial/network port on which the command was received. CMD Param_1 Y8 1=Enable, 0=Disable Example: void EnableAudioTallies(bool Enable) { remote_send("Y8%d", Enable); } Note: Audio tallies may also be enabled via the Set Passive Mode (Ya) command (page 247).
Automation Protocol Video Commands Possible values for the Voice Over positions are: Note: VOICE_OVER_OFF VOICE_OVER_ON 0 1 VOICE_OVER_INBETWEEN 2 For Imagestore 2, parameters 3 and 4 are “Voice Over 1 Pair 1” and “Voice Over 1 Pair 2” respectively.
Automation Protocol Video Commands Image Preload Tally YA The Y6 command (page 63) enables or disables unsolicited video tallies for the serial/network port on which the command was received. One of these video tallies is the Image Preload Tally (YA) which returns the filename of the image that is currently pre-loaded into a layer – via R7 (page 93). Cmd Param_1 Param_2 YA %1x Layer No. %s Image File Name YA tallies do not get sent in bulk as video tallies are enabled.
Automation Protocol Video Commands Once media tallies are enabled, unsolicited tallies are issued every time a matching media file is added, deleted or modified. The format of the YB tally response is as follows: CMD YB Param_1 %06x Media Type (not bitwise) As defined above Param_2 %1x 0x0 = Deleted 0x1 = Added 0x2 = Modified Param_3 %s Media File Name The first parameter reports the media file type. This can not be a bitwise combination of media types since the tally is for a single media file.
Automation Protocol Video Commands Heartbeat Tally YD This command enables or disables heartbeat unsolicited tallies for the serial/network port on which the enable command was received. This command also sets the number of frames between each heart beat tally being sent.
Automation Protocol Video Commands Fade-To-Black State Tally Yf The Y6 command (page 63) enables or disables unsolicited video tallies for the serial/network port on which the command was received. This includes the Yf tally which returns keyer Fade-to-Black position information for each layer as state changes (unsolicited). CMD Yf Param_1 %1x Layer No.
Automation Protocol Video Commands Animation/Clip Cycle Tally Yj Note: This command is only valid for Imagestore Intuition. This command is only enabled if either the video tallies are enabled (Y61) or the Imagestore Intuition is set to operate in passive mode [Ya1]. This tally is sent by Intuition every time a cell animation/clip that been setup to send this tally had cycled. The tally is sent at the end of each cycle and is enabled using the Y6 or the Ya command.
Automation Protocol Video Commands Keyer Position Tally Note: 3 The Y6 tally returns keyer position state for DSK1 and DSK2. The 3 tally is therefore only implemented on products with more than two keying layers – (Intuition, Imagestore 750 and LGK3901). The Y6 command (page 63) enables or disables unsolicited video tallies for the serial/network port on which the command was received. This includes the 3 tally which returns keyer position information for each layer as state changes (unsolicited).
Automation Protocol Audio Commands (old) Audio Commands (old) Note: The commands in this section are largely deprecated and ONLY apply to Imagestore 2 with ‘Easysound’ option disabled. More recent Imagestore products utilise the Easysound audio model which is described on page 159. Audio commands are applicable to systems that have the Easysound audio mixer layer fitted. The audio system is viewed as a matrix with variable gain cross-points.
Automation Protocol Audio Commands (old) Audio Commands Table The table below shows the commands used to control the audio layer. Each entry in the table shows a parameter to be put in the command string. These parameters are not separated by spaces as they are all of fixed length. The values for each parameter are of set types that are described in the section starting page 80. The number ranges for most parameters are zero-based.
Automation Protocol Audio Commands (old) Matrix Input Preselect Note: a This command is largely deprecated. This command selects which physical input is pre-selected to the matrix input. The parameters are the matrix input and the pre-select input. Example: void SetInputPath(UINT8 byPhysio, UINT8 byPathNo) { remote_send("a%c%c", byPathNo+0x20, byPhysIo+0x20); } Set Input Mode b Note: This command is largely deprecated.
Automation Protocol Audio Commands (old) This command sets the proportion of each input passed in a stereo input or the position of a mono input into a stereo mix. This takes an input and a pan value. Set Mix Note: d This command is largely deprecated. This command sets one or more contributions to a given mix. All inputs that are not explicitly mentioned in the command are unchanged. At least one mix_block must follow the matrix output value.
Automation Protocol Audio Commands (old) byInPathNo+0x20, byPatchSource+0x20); } Set Output Gain Note: g This command is largely deprecated. This command sets the fade to silence fader associated with a patch panel output. The duration value sets the number of frames over which the action is to take place.
Automation Protocol Audio Commands (old) Parameter Ranges & Meanings This section explains the format of the parameters used within the audio commands listed in the table on page 76. phys_io This is used to pre-select the source taken into a matrix input or the destination to which an output is sent. Values can be selected from embedded channel pairs or from separate physical AES streams. Value 0x20 selects embedded channel pair 1. 0x27 selects channel pair 8. 0x28 selects the associated AES stream.
Automation Protocol Audio Commands (old) io_mode I/O mode defines the way that commands for inputs and outputs are interpreted. For inputs this controls whether the input is a separate mono input or is treated as part of a stereo pair. It also controls whether the signal is phase inverted or replaced by silence. For outputs, only the mono/stereo bit is significant.
Automation Protocol Audio Commands (old) wide and is a path_no. The remaining 4 bytes are encoded as two hexadecimal values each of two bytes width. The first value selects the contributing input, the second value is the required gain, and the third value is the duration, in video frames, over which the transition is to take place. Example: 0x23 0x36 0x30 0x32 0x30 0x23 > path 3 if MONO, 3 and 4 if STEREO 0x36 0x30 -> 60(hex) -> 96 -> (96/2) - 99.5 = -51.
Automation Protocol Audio Commands (old) Easysound Automation Block Diagram Miranda Technologies Ltd Page 83
Automation Protocol Miranda Technologies Ltd Extended Commands Page 84
Automation Protocol Extended Commands Extended Commands Extended commands are two-byte commands with parameters following immediately on from the second command code byte. The first command byte identifies a command group, with the second byte identifying the specific command within the group. All extended commands use fixed-width hexadecimal representations for integer parameters. All string parameters are variable length, and are therefore grouped at the end of the packet.
Automation Protocol Extended Commands } Some floating-point parameters are converted to 16.16 fixed-point integer representation, and sent as an 8-character hex field, so 3.5 would be sent as 00038000. long oxfix(float f) { return f * 0x10000; } ... send_command(“ZZ%08x%08x”, oxfox(PI), oxfix(1.23456)); ...
Automation Protocol Filename-Based Commands Filename-Based Commands The following commands are provided to allow access to images stored on the Oxtel Series products. These products support alphanumeric filenames (including the file extension) of up to 39 characters. Generally speaking the file-systems on Oxtel Series products are case insensitive. However this is not the case for Imagestore HD-TV, Imagestore 300, and Intuition products that utilise the EXT2 file-system.
Automation Protocol Filename-Based Commands Example 1: void LoadEmergencySlide(int Layer) { remote_send("R0%1x%s", Layer, "Emergency.oxa"); } Example 2: void LoadNumberedImage(int Layer, int num) { //Equivalent to remote_send(“8%x %x”,Layer,num); remote_send("R0%1xV%03d", Layer, num); } When no filename is specified the R0 command alternatively responds with the name of the currently loaded file. This is useful when enquiring which file is loaded into a layer. CMD R0 Param_1 %1x: Layer No.
Automation Protocol Save Image Filename-Based Commands R1 This saves a previously loaded or grabbed image to disk. The Image is saved with all its currently selected keying, masking and positioning attributes. The mask flag is only used in Imagestore 2/3. If the Mask Flag is 0, then the entire image is saved. If the mask flag is 1, then only the area of the image within the current mask rectangle is saved, thus reducing disk space and increasing load times.
Automation Protocol Filename-Based Commands Example: void EraseEmergencySlide() { remote_send("R2%s","Emergency.oxa"); } Enquire File Info R3 This command retrieves whether a specified media file exists (or not) on the unit’s internal disk. This command supersedes and extends the ‘P’ command (which remain supported). Note: To query audio files use the R8 command. CMD R3 Param_1 Filename Example: void EnquireEmergencySlide() { remote_send("R3%s","Emergency.
Automation Protocol Filename-Based Commands The folder name alias is a string which can be one of the following • $VIDEO: Image directory • $AUDIO: Audio directory • $FONTS: Font directory Example: void QueryFirstFile () { remote_send("R4%s","$VIDEO"); } The information returned is: Format Field Description %c%c %1x %s Cmd End of directory Filename R4 1 = End of directory reached, 0 = Otherwise.
Automation Protocol Filename-Based Commands Format %c%c %1x Field Cmd End of directory Description R5 1 = End of directory reached, 0 = Otherwise. %s Filename Name of the file, or “unknown” if directory does not exist, or “end” if end of directory reached Enquire Extended File Info R6 This command retrieves information about a specified image, animation or clock from the internal disk of the Imagestore device.
Automation Protocol Filename-Based Commands Example of parsing the information returned (using C).
Automation Protocol Filename-Based Commands Example 1: void PreloadEmergencySlide(int Layer) { remote_send("R7%1x%s", Layer, "Emergency.oxa"); } Enquire Audio File Info R8 This command retrieves whether a specified audio file (OXE, OXW or WAV) exists on the Imagestore unit’s hard disk. This command supersedes and extends the ‘Q’ command (which remains supported). Note: OXE files are not supported by Imagestore 2/3. CMD R8 Param_1 Filename Example: void EnquireAudioFile() { remote_send("R8%s","song.
Automation Protocol Filename-Based Commands Example: void EmergencyToAir(bool onOff) { remote_send("R9%1x", onOff); } Image Load Mode Rm This command sets the current image load mode for the specified layer. Mode can be one of the following: 0: Clean Load: Old image cut down New image loads New image cuts up 1: Cut Load: Old image held while new image loads Cut to new image CMD Rm Param_1 Layer No.
Automation Protocol Filename-Based Commands Example 2: void EnquireImageLoadMode(int Layer) { remote_send("Rm%1x", Layer); } The information returned is: Format Field Description %c%c %1x %x Cmd Layer Mode Rm Layer No. Current mode Validate Template RA This command allows the media references made within Intuition templates to be validated. Intuition template files typically reference many other media files including OXT images, and OXI animations.
Automation Protocol Filename-Based Commands 2) The template exists, and all related media is present on the unit: RAMyTemplate.tem|10000 3) The template exists, but one related media file is missing (test1.oxi): RAMyTemplate.tem|10001|test1.oxi 4) The template exists, and media files test1.oxi -> test256.oxi are missing: RAMyTemplate.tem|10100|test1.oxi|test2.oxi|test3.oxi|......|test256.
Automation Protocol Miranda Technologies Ltd Animation Commands Page 98
Automation Protocol Animation Commands Animation Commands The animation control commands are used to control the playout of animation sequences which have been loaded into the playout memory. They can be used to trigger ‘single-shot’ animations, and make other types of animation. On Intuition units, animations occupy a template box rather than a full layer. These commands imply a box number of 0. See also the Zf command on page 232. Note that these commands are not supported on the DSK-3901.
Automation Protocol Animation Commands Example: void StopAnimationImmediate(int layer) { remote_send("S1%01x1",layer); } Select Animation Frame S2 This command sends the animation to a specified frame. If the animation is running the animation will continue to run from the specified frame. If the animation is halted, then the specified frame will be displayed but the animation will remain halted. CMD S2 Param_1 %1x: Layer No. Param_2 %4x: Field No.
Automation Protocol Note: Animation Commands Wipe on from centre (barn door) 15 35 Wipe on from centre (blinds) 16 36 The S3 command is only supported by Imagestore 2. Restart Animation S4 This command always restarts an animation playing out from the beginning. This command is a convenient alternative to the S0 command when the animation has to always start from the first field. CMD Param_1 S4 %1x : Layer No.
Automation Protocol Miranda Technologies Ltd Bugclock Controls Page 102
Automation Protocol Bugclock Controls Bugclock Commands The Bugclock commands allow the control of the timer features of a Bugclock image, for units where Bugclocks are supported. Clocks can be loaded, positioned, keyed, etc. using the standard commands for stills and animations (R0, G, 3, etc.). Stop Timer T0 This command pauses a Bugclock timer on the specified layer. CMD T0 Param_1 %01x : Layer No.
Automation Protocol Bugclock Controls Reset Timer T2 This command resets the Bugclock timer on the specified layer to its default time value. For count-up timers, this is typically zero. CMD T2 Param_1 %01x : Layer No. Example: void ResetTimer(int layer) { remote_send("T2%01x", layer); } Set Timer to Value T3 This command sets a Bugclock timer to the specified value. Time-of-day clocks and time-of-day countdowns are not affected. CMD Param_1 Param_2 Param_3 Param_4 T3 %01x : Layer No.
Automation Protocol AB Mixer Commands AB Mixer Commands These commands control the AB mixer functionality of the Imagestore. For older products, SDI inputs A and B provide fixed inputs for the AB mixer. However newer products with an input router (Imagestore HD-TV and Imagestore 750) are able to route any of the available SDI inputs into the AB mixer.
Automation Protocol AB Mixer Commands Example: void FadeToA(int fields) { remote_send("U2%03x", field); } Fade to B U3 This command fades to the B input over a specified number of fields. Cut AB CMD Param_1 U3 %03x: Fields U4 This command cuts to the opposite input from the one currently visible CMD U4 X-Fade AB U5 This command fades to the opposite input to the one currently visible over specified number of fields.
Automation Protocol AB Mixer Commands 01: V-Fade 03: X-Fade 05: Cut 06: Wipe L to R 07: Wipe T to B 10: Wipe R to L 11: Wipe B to T Note: Wipes are NOT supported on Imagestore HD-TV, Imagestore 750, LGK-3901 or DSK-3901. Example: void SelectCrossFade(); { remote_send("U603"); } Note: To set a colour field for the mid-point of a V-Fade, use the UD command. Wipe Softness Adjustment U7 This command sets the edge softness for Horizontal and Vertical wipes. Softness is measured in arbitrary units.
Automation Protocol V-Fade AB AB Mixer Commands U8 This command causes the AB mixer to fade from the current input to the other via the V-fade colour (see UD) over specified number of fields. A separate duration for the up and down phases is supported if asymmetric Vfades are required. CMD U8 Param_1 %03x: Fields for ‘down’ section of fade. Set Absolute Mix Param_2 %03x: Fields for ‘up’ section allows for asymmetric V-fades U9 This command sets the AB mix position to the specified absolute value.
Automation Protocol AB Mixer Commands Fade to Specified Position UC Transitions the AB Mixer to the specified position over the given number of fields. The position can be anywhere from 0 (A) to 0x200 (B) and all values in between. This can be used for U-Fades, by selecting V-Fade transition type (U2 above), then sending for example UC100050 (transition to mid-point of V-Fade) on Take pressed, then UC200050 (transition to B) on take released.
Automation Protocol AB Mixer Commands CMD UE Param_1 Mixer Param_2 Source Example 1: void SelectMixer(int Mixer, int Source) { remote_send("UE%1x %1x", Mixer, Source); } The command UE alternatively responds with the current source for the mixer if no source is specified.
Automation Protocol AB Mixer Commands The Status report returned is. Format %c%c Field Cmd Description Ua %02x Transition type Imagestore 300[+] / HD-TV / 750 Return type is consistent with the U6 command Imagestore 2 / 3 Cut =0 X-Fade =1 V-Fade =2 Wipe left to right =3 Wipe right to left =4 Wipe top to bottom =5 Wipe bottom to top =6 %03x %03x %03x AB mix rate Wipe softness AB Mix angle Value in fields Value between 0-128 (0x000-0x080) 0 = mixer at A, 512 (or 0x200) = mixer at B.
Automation Protocol AB Mixer Commands Alternatively the command Ub responds with the AB cut mode that is currently set. CMD Ub Example: void EnquireABCutMode(void) { remote_send("Ub"); } The information returned is: Format %c%c %02x Note: Field Cmd Mode Description Ub Cut/Fade Mode When zero length AB fades are used, the timing of these events may not synchronise with “true cuts” depending on how the cut and fade modes are currently set up.
Automation Protocol DVE Hardware Options DVE Hardware Options The Imagestore products support a range of different DVE hardware options which are summarised in the table below.
Automation Protocol Miranda Technologies Ltd Squeezy Commands Page 114
Automation Protocol Squeezy Commands Squeezy Commands These commands relate to the ‘Squeezy’ hardware option for Imagestore 2 and Imagestore 3. Please refer to the table on page 113. The Squeezy DVE is controlled by using preset positions and sizes, and performing moves to specified preset. Up to 255 presets are available (0x1to 0xFF). Preset 0 cannot be overwritten, and is always the nominal ‘unsqueezed’ image.
Automation Protocol Squeezy Commands Example: long oxfix(float f) { return f * 0x10000; } void SetPreset(int preset, float xpos, float ypos, float xsize, float ysize) { remote_send("W0%02x%08x%08x%08x%08x", preset, oxfix(xpos), oxfix(ypos), oxfix(xsize), oxfix(ysize)); } Select Squeeze Configuration W1 This determines where in the signal flow the Squeezy hardware is configured. Note: Changing the squeeze configuration can cause instant changes in program output as it also affects keyer priorities.
Automation Protocol Squeezy Commands Run Squeeze Move W2 Runs a squeeze move to a particular preset position over a specified duration. CMD W2 Param_1 %02x : Sequence No.
Automation Protocol Squeezy Commands Select Preset Borders W4 Setup the border positions associated with a squeeze preset. Borders can be used to simulate wipes. For example, squeezing from full screen to a preset with a Left Border of 1.0 will ‘wipe’ the video off to the right. CMD W4 Param_1 %02x : Preset No.
Automation Protocol 2D/3D DVE Commands 2D/3D DVE Commands These commands relate to the ‘Ross 2D/3D DVE’ and ‘2D DVE’ hardware options for Imagestore 3, Imagestore 300[+], Imagestore HD-TV and Imagestore 750. Please refer to the table on page 113. The 2D/3D DVE preset represents a time-lined sequence of user defined keyframes. We refer to this as a DVE sequence.
Automation Protocol 2D/3D DVE Commands consists of time-lined progression of keyframes which define the position/size of the video, and how to move from one keyframe to the next. Before implementing a 2D/3D DVE automation driver, please read the section on page 125. This will explain the best way to drive the device. Select 2D/3D DVE Configuration W1 Select the DVE configuration mode. This determines where in the program channel signal flow the 2D/3D DVE hardware is configured.
Automation Protocol 2D/3D DVE Commands Mode Description Video Inputs (channel 1&2) Video output position 0x0 None (delay) - 1 frame audio/video delay - - 0x1 AB Mixer A&B 0x4 AB over DSK1 A&B 0x9 Bypass - Behind both keying layers Between DSK1 and DSK2 - The DVE configuration modes available on the Imagestore 750 2D DVE are as follows… Mode Description Video Inputs (channel 1&2) Video output position 0x0 - - 0x4 None (delay) - 1 frame audio/video delay Enabled A&B K1K2 DVE K3K4
Automation Protocol 2D/3D DVE Commands Sequence number: Sequence Number Description 0x00 0x01x-0x61 0x01x-0x63 (IS3 only) Play the currently loaded sequence in reverse Load and run the specified sequence number Sequence 0 is always used to play the current sequence in reverse. So if you have a sequence which takes full screen video and squeezes it down to a small box, then re-calling sequence 0 will take it back to full screen video.
Automation Protocol CMD W7 2D/3D DVE Commands Param_1 %03x : Duration 1 = Default Param_2 (Optional) %1x: DVE Mask (Imagestore 750 only) 0x1=Program, 0x2=Preview, 0x3=Program and preview Run Sequence in Reverse W8 Runs the currently loaded sequence in reverse over a specified duration. Setting the number of frames/fields to 1, runs the sequence at the speed it was designed at. Maximum duration is 999 (0x3E7). The duration depends on the product and standard, as defined within the W2 section.
Automation Protocol 2D/3D DVE Commands Select DVE Routing Input WR This command only applies to Imagestore 750 and sets the input the to program DVE or the preview DVE.
Automation Protocol 2D/3D DVE Commands How to use 2D/3D DVE via Automation In normal Imagestore operation the 2D/3D DVE is not in circuit and the DVE mode is set to none (0). DVE none adds a one frame of video/audio delay so that when the DVE is switched in and out of circuit there is no jump in the video. Before switching the 2D/3D DVE in circuit, it is often required to start on full screen A. The best way to do this is to make sure all sequences start on full screen A.
Automation Protocol Miranda Technologies Ltd Easyplay Commands Page 126
Automation Protocol Easyplay Commands Easyplay Commands This set of commands is only available if the unit has the Easysound audio mixer and Easyplay options installed. Load Audio Clip k0 Loads an audio clip in preparation for playout. CMD k0 Param_0 %01x Layer No.
Automation Protocol Easyplay Commands Stop Playout k2 Stop playout of an audio clip CMD k2 Unload Audio Clip Param_1 %1x Layer No. k3 Unloads an audio clip from its store slot. This prevents the audio clip from being played out automatically when its associated keyer is cut up. CMD Param_1 k3 %1x Layer No. Enquire Audio Clip k4 Enquires the loaded Easyplay audio clip name for a given store. Miranda Technologies Ltd CMD Param_1 k4 %1x Store No.
Automation Protocol Extended Status Commands Extended Status Commands Temperature Monitoring X0 Returns information about the current temperature within the unit. CMD X0 The information returned is: Format %c%c %5f Field Cmd Temperature Description X0 In degrees Celsius Enquire Licence Code Note: X1 LGK-3901 and DSK-3901 licences cannot be enquired using the X1 command, and will return ” X100000” to all enquiries. Use iControl to view the licences.
Automation Protocol Extended Status Commands Insert Log Message X2 Adds a text message to the Imagestore unit’s log file. This log can be interrogated and viewed by support engineers, and recent log entries can be seen on the Imagestore’s preview output when in Swap/Preview mode.
Automation Protocol Extended Status Commands Return Input Colour Field Values X5 This command returns information about the various input colour field values on an Imagestore.
Automation Protocol Extended Status Commands %06x Fill 2 colour field %01x Key 2 mode 1 = Colour field, 0 = Other %06x Key 2 colour field RGB value %01x C/Fill 3 mode 1 = Colour field, 0 = Other %06x C/Fill 3 colour field RGB value %01x D/Key 3 mode 1 = Colour field, 0 = Other %06x D/Key 3 colour field RGB value Enquire Voltages Note: RGB value X6 LGK-3901 and DSK-3901 do not support the X6 command.
Automation Protocol Extended Status Commands The information returned on Imagestore 750 is: Format Field Description %c%c %05.1f Cmd Ambient Temperature 12V PSU A supply X6 In degrees Celsius %03.2f 12V PSU B supply 1.00=OK, 0.00=Failed or not fitted %03.2f %03.2f 12V supply Video Voltage Check %03.2f DVE Voltage Check %03.2f 0.00 In volts. Worst case measurement 1.00=OK, 0.00=Failed. Checks all video board voltages are within tolerances 1.00=OK, 0.00=Failed.
Automation Protocol Extended Status Commands This command will respond with the status of a GPI line. The GPI number is the zero based GPI line number between 0 and 7 CMD X8 Param_1 %01x 0 = Video GPI Lines 1 = Audio GPI Lines (if supported) Param_2 %02x: GPI Number Response format CMD Param_1 Param_2 X8 %02x: GPI No.
Automation Protocol GPI Special Extended Status Commands X9 This command can perform two functions. One of the functions is to return a status message containing a bit mask of the GPI input status. The other function is to set the physical output status of a GPI. CMD X9 Note: Param_1 %01x 0=Turn GPI off 1=Turn GPI on 2=Request Status Param_2 %02x GPI number (Not required for status request).
Automation Protocol Extended Status Commands Example: void EnquireExtLayerStatus(void) { remote_send(“XA”); } The information returned is: Format Description XA Imagestore Midground Layer (DSK 0) %c %c Field Cmd Layer (0=DOWN, 1=UP) Layer Layer %c %c %c Layer Layer Layer Intuition Layer 1 (0x1) Intuition Layer 2 (0x2) Intuition Layer 3 (0x3) %c %c %c Layer Layer Layer Intuition Layer 4 (0x4) Intuition Layer 5 (0x5) Intuition Layer 6 (0x6) %c %c %c Layer Layer Layer Intuition Layer 7 (0x7) Intu
Automation Protocol Extended Status Commands CMD Param_1 Param_2 XB %01x: GPI No. %01x: 0 = Off, 1 = On Example: void GPIOutputStatus(int GPI, bool Status) { remote_send(“XB%01x %01x”, GPI, Status); } Serial Baud Rate XC This command sets the baud rate for the specified serial port number. CMD Param_1 Param_2 XC %1x: Port No.
Automation Protocol Extended Status Commands Time Code Source XE This command sets the current Time Code source choosing between two possible values, 0 = Linear Time Code (LTC) and 1 = Vertical Interrupt Time Code (VITC). CMD Param_1 XE %x: Source Example: void SetTimeCodeSource(int Source) { remote_send(“XE%x”, Source); } The command XE alternatively responds with information about the time code source.
Automation Protocol Set Preview Extended Status Commands XH This command sets the current preview mode as follow: CMD Param_1 XH %02x: Preview mode The supported preview modes are: 0x00: DSK 1 Key o/p 0x01: DSK 2 Key o/p 0x02: DSK 1 o/p 0x03: Program o/p 0x04: DSK 2 Fill o/p 0x05: DSK 1 Fill o/p 0x06: SDI A 0x07: Fill-1 0x08: Key-1 0x09: SDI B 0x0A: AB Mixer o/p 0x0B: Presmaster Preview 0x0C: Fill-2 (Optional) 0x0D: Key-2 (Optional) For Imagestore 750 the supported preview modes are: 0x02: PGM DSK 1
Automation Protocol Extended Status Commands 0x00: Store 1 Key 0x04: Store 2 Fill 0x01: Store 2 Key 0x13: Store 3 Fill 0x14: Store 3 Key For DSK-3901 the supported preview modes are: 0x03: Program output 0x0B: Preview output 0x02: PGM DSK 1 output 0x07: SDI Fill-1 0x08: SDI Key-1 0x0C: SDI Fill-2 0x0D: SDI Key-2 Example: void SetPreview(int Preview) { remote_send(“XH%02x”, Preview); } The command XH alternatively responds with the current preview mode.
Automation Protocol Extended Status Commands CMD Param_1 XI %1x: Reference Example: void SetReference(int Reference) { remote_send(“XI%x”, Reference); } The command XI alternatively responds with the current reference mode.
Automation Protocol Extended Status Commands Example: void SetClockOffset(int Reference, int ClockOffset) { remote_send(“XJ%1x%06x”, Reference, ClockOffset); } The command XJ alternatively responds with the current clock offset related to the reference mode.
Automation Protocol Extended Status Commands The highest four digits of the serial number define the product code, and the lowest four digits define the unit ID. The exception is Imagestore 750 where the four digit product code is followed by a zero then a three digit unit ID. The full serial number for an Imagestore 750 can be obtained using the XU command (see page 149).
Automation Protocol Extended Status Commands XM %1d: Input %1d: Mode The command behaviour depends on the model of Imagestore, as follows: Imagestore 300[+] and Imagestore HD-TV Each input has a dedicated colour field set via the L command (page 48). The supported modes are therefore: 0: Pass SDI 1: Force Colour Field Imagestore 750 There are three independent colour fields (again set by the L command) that can be routed to any input(s).
Automation Protocol Extended Status Commands Serial Protocol XN This command sets the protocol for the specified serial port number. It is closely related to the XC command which sets the baud rate of a given serial port.
Automation Protocol Extended Status Commands Format %c%c %x Field Cmd Port Description XN Serial Port number %x Protocol Current Protocol Clean Feed XP This command sets one of the auxiliary channels as the current clean feed input, if supported.
Automation Protocol Extended Status Commands Example: void SetCleanFeed(int CleanFeed) { remote_send(“XP%2x”, CleanFeed); } The command XP alternatively responds with the current clean feed channel. Format %c%c Field Cmd Description XP %2x Clean Feed Current clean feed channel Get Total Fill/Key XR This command returns how many Fill & Key are currently supported by the Imagestore. The returned value is normalised from zero.
Automation Protocol Monitor Feed Extended Status Commands XT This command sets the feed displayed by the monitor for an Imagestore 750: CMD Param_1 XT %02x: Monitor Feed Possible settings for the Imagestore 750 monitor feed are as follows: 0x00: Program (factory default) 0x01: Preview 0x02: SDI A 0x03: SDI B 0x04: SDI C 0x05: SDI D 0x06: Program AB Mixer 0x07: Preview AB Mixer 0x08: Store 1 Fill 0x09: Store 1 Key 0x0A: Store 2 Fill 0x0B: Store 2 Key 0x0C: Store 3 Fill 0x0D: Store 3 Key 0x0E: Store 4
Automation Protocol Extended Status Commands Please note that: • DSK fill and key outputs are routed from the stores, not the keyers • For IS750 LOGO this command will be ineffective unless the ISMF licence is enabled. Get Extended Serial Number XU This command returns the full fifteen digit extended serial number of an Imagestore 750.
Automation Protocol Extended Status Commands The values broadcast in the response are separated by spaces. Format Field Description %c%c %05.1f Cmd Ambient Temperature %05.1f %05.1f %05.1f %05.1f %05.1f %05.1f %05.1f %03.2f %03.2f %03.2f %03.2f %03.2f %03.2f %03.2f %03.2f %03.2f %03.2f %03.2f %01x %01x %01x %01x %03.2f %03.2f %03.2f %03.2f %03.
Automation Protocol Extended Status Commands Get Input Status XX This command returns the current status of the Imagestore 750, DSK-3901 and LGK-3901 input requested: CMD Param_1 XX %1x: Input Where the Imagestore 750 inputs are numbered in the following order.
Automation Protocol Extended Status Commands The DSK-3901 and LGK-3901 return uses the following format: Format Field Description %c%c Cmd XR %1x Input Input enquired %1x Status Status of input, 0=unlocked, 1=locked %1x Standard Standard of input, 0 = PAL, 1 = NTSC, 2 = 1080i 59.94Hz, 3 = 1080i 50Hz, 4 = 720p 59.94Hz, 5 = 720p 50Hz, 5 = 1080p 59.94Hz at level A, 6 = 1080p 50Hz at level A, 7 = 1080p 59.94Hz at level B, 8 = 1080p 50Hz at level B, f = Unknown (e.g.
Automation Protocol Extended Status Commands For example Xe20070302230010 Sets the date to be 2nd March 2007and the time to be 23:00:10. Store-Keyer Configuration Xi Note: Changing the store-keyer configuration unloads all stores. The store-keyer configuration cannot be changed when EAS is active. This command is only supported on the LGK-3901.
Automation Protocol Set Standard Extended Status Commands Xs This command sets the standard: CMD Param_1 Xs %x Standard The standard refers to: 0 1 2 PAL NTSC 1080i 59.94 Hz 3 4 5 1080i 50Hz 720p 59.94Hz 720p 50Hz For LGK-3901, DSK-3901 with SD, HD and 3G the standard refers to: 0 1 PAL NTSC 2 3 4 1080i 59.94 Hz 1080i 50Hz 720p 59.94Hz 5 6 7 720p 50Hz 1080p 59.94 Level A 1080p 50 Level A The standard can be enquired using: CMD Xs The return is consistent with the set standard format.
Automation Protocol Extended Status Commands The output refers to: 0 Program 1 2 Preview Clean Feed Please note that there is no delay capability for the Monitor Feed in Imagestore 750. LGK-3901 and DSK-3901 do not support frame delays. The frame delay can also be enquired using: CMD Param_1 Xt %1x Output The return is consistent with the set frame delay format. Get AES Audio Signal Type Note: Xu This command is only supported by Imagestore 750 v2.0 or higher.
Automation Protocol Extended Status Commands Get Embedded Audio Signal Type Note: Xv This command is only supported by Imagestore 750 v2.0 or higher. This command gets the embedded audio signal type for a given channel: CMD Param_1 Param_1 Xv %02x Audio Feed 0 = A, 1 = B, 2 = C, 3 = D %02x Audio Channel No.
Automation Protocol Extended Status Commands Example: void SetCleanFeed(int CleanFeed) { remote_send(“Xx%s”, “/home/configs/Name.xml”); } The information returned indicates whether the configuration file was correctly imported.
Automation Protocol Miranda Technologies Ltd Audio Commands Page 158
Automation Protocol Audio Commands Audio Commands These automation commands have been developed to support the Easysound audio model. This enables users to control audio with greater flexibility than with earlier systems (as described on page 75). Care should be taken to ensure that the two control methods are not used together. All commands which address this system are preceded by a lower case ‘j’.
Automation Protocol Inputs Audio Commands j0 Input parameters can be changed remotely to suit applications. Channels can be adjusted, phase inverted, shuffled and selected via the command strings listed below. Control Input ‘j0’ Input Number Function Function Parameters The command j0 instructs the Oxtel unit that a parameter of an audio input is to be changed. The first parameter to be sent is the audio input number. Each input consists of 4 channels (equivalent to one group or two AES pairs).
Automation Protocol Audio Commands If Channel/Pair/Group is given a value of 4, then the whole group (4 channels) is affected and the Channel Number parameter is ignored. Shuffle j0 0 The shuffle values allow mono input channels to be moved around within a group. In this way pair swaps can be achieved. Each output channel can take its input from any one of the input channels. Each input can be copied to multiple output channels.
Automation Protocol Audio Commands Mute j0 1 Channels, pairs or groups can be muted with one command.
Automation Protocol Audio Commands void SetInputTrim(int Input, int ChannelPairGroup, int Channel, float Trim); { remote_send("j0%01x2%01x%01x%02x ", Input, ChannelPairGroup, Channel, dBval(Trim)); } Phase j0 3 Channels, pairs or groups can be phase inverted with one command.
Automation Protocol CMD j0 j0 Input %01x Input 1, 2 or 3 Audio Commands Function %01x Level 4 Param_1 %01x Channel/Pair/Group 1, 2 or 4 Param_2 %01x Channel 0, 1, 2 or 3 Param_3 %02x Level dbVal void SetInputLevel(int Input, int ChannelPairGroup, int Channel, float Level); { remote_send("j0%01x4%01x%01x%02x", Input, ChannelPairGroup, Channel, dbVal(Level)); } Input Source j0 5 The A/BGND input and the B/Voice-over 2 input have the ability to pick audio from either the incoming AES streams or the a
Automation Protocol Audio Commands void SetInputTrim(int Input, int Pair, int Source); { remote_send("j0%01x5%01x%01x", Input, Pair, Source); } Outputs j1 There are two outputs from the Easysound audio mixer; Program and Preview. The preview output allows the operator to monitor various audio mixes and levels before taking the desired effect ‘to air’. The preview output can also be used for effects send and return applications. The program output is the main audio output.
Automation Protocol Audio Commands Output Level via Gain Type j1 3 In Imagestore 750 and version 1.13.5 of Imagestore 300[+] and Imagestore HD-TV, extended output gain control is introduced for all audio channels (embedded and AES) – not just channels within the first group. The mixfile command g (see page 79) is used to associate a set of audio channels with an output gain type (for example, PROGRAM_OUTPUT).
Automation Protocol Audio Commands void SetInputMute(int ChannelPairGroup, int Channel, int Mute); { remote_send("j101%01x%01x%01x", ChannelPairGroup, Channel, Mute); } Output Embed j1 2 The outgoing audio can be embedded to one of the four audio groups in the output video. The group number can be selected with the following string.
Automation Protocol Audio Commands Imagestore 2/3 A/B mix mode provides two stereo pair voice-overs that can be inserted into the result of the mix. The voice-over in the A/B mix mode is named VoiceOver 1. Two voice-over mode provides four stereo pair voice-overs that can be inserted into the background or program audio. The Voice-overs in Two voice-over mode are named Voice-Over 1 and Voice-Over 2. This mode is rarely used since one SDI input is lost to provide inputs for the second voiceover.
Automation Protocol Audio Commands Duck Preset j2 0 This sets the attenuation of the background audio when the voice-over is on.
Automation Protocol Audio Commands Voice-over Level j2 2 This command allows the voice-over to be directly turned on, off or set to an intermediate position. Normally the voice-over would be controlled by the fade/cut voice-over transition commands, but this command allows voiceovers to be controlled via a T-bar or external fader.
Automation Protocol Audio Commands Fade to/from Silence j30 CMD Function Param_1 j3 %01x Transition 0 %03x Duration in fields 0 to 600 (0x000 to 0x258) j3 void SetSilenceRate(int fields); { remote_send("j30%03x", fields); } Fade A/B j31 CMD j3 j3 Function %01x Transition 1 Param_1 %03x Duration in fields 0 to 600 (0x000 to 0x258) void SetABRate(int fields); { remote_send("j31%03x", fields); } Fade Voice-over 1 Pair 1 j32 CMD Function Param_1 j3 %01x Transition 2 %03x Duration in fields
Automation Protocol Note: Audio Commands For Imagestore 300[+] and Imagestore HD-TV this command has different usage since it is used to fade all channels in voiceover 1. It should therefore be named ‘Fade Voice-over 1’.
Automation Protocol Audio Commands Fade Voice-over 2 Pair 2 j35 CMD Function Param_1 j3 %01x Transition 5 %03x Duration in fields 0 to 600 (0x000 to 0x258) j3 void SetVO2Rate(int fields); { remote_send("j35%03x", fields); } Note: For Imagestore 300[+], Imagestore HD-TV and Imagestore 750 this command is unsupported. Transitions j4 The Easysound can perform many automatic transitions. Cutting and fading mixes, voice-overs and output levels.
Automation Protocol Fade A/B Audio Commands j41 When in A/B mix mode, fades between the A and B audio. If the destination is A then Param_1 takes the value of 0. If the destination is B then Param_1 should be 1. CMD j4 j4 Function %01x Transition 1 Param_1 %01x Destination A/B 0 or 1 void ABFade(int Destination); { remote_send("j41%01x", Destination); } Cut to/from Silence j42 Cuts the audio output to and from silence. If cutting to silence then Param_1 takes the value of 0.
Automation Protocol Audio Commands void SilenceFade(int Silence); { remote_send("j43%01x", Silence); } Fade Voice-over 1 From/To Silence j44 Fades voice-over one up and down. Voice-over pairs can be controlled independently so a ‘pairs’ parameter is provided. Parameter 2 dictates the destination of the transition, 0 to fade the voice-over down and 1 to fade the voice-over up.
Automation Protocol Audio Commands void VO2Fade(int Destination); { remote_send("j442%01x", Destination); } Fade Voice-over 2 From/To Silence j45 As for voice-over 1. CMD j4 j4 Function %01x Transition 5 Param_1 %01x Pair 1 or 2 Param_2 %01x To/From Silence 0 or 1 void VO2Fade(int Pair, int Destination); { remote_send("j45%01x%01x", Pair, Destination); } Note: For Imagestore 300[+], Imagestore HD-TV and Imagestore 750 this command is unsupported. Both VO1 and VO2 are faded using the “j4 4” command.
Automation Protocol Note: Audio Commands For Imagestore 300[+], Imagestore HD-TV and Imagestore 750 this command has different usage.
Automation Protocol Note: Audio Commands For Imagestore 300[+], Imagestore HD-TV and Imagestore 750 this command is unsupported. Both VO1 and VO2 are cut using the “j4 6” command. Audio Follow Video j5 Commands can be sent to the Easysound such that audio levels follow video transitions. Audio Follow Fade to Black j50 The main audio output level follows the output video ‘fade to black’ state. If the program video is faded to black, the audio will fade to silence.
Automation Protocol Audio Commands Audio Follow Keyers j52 The audio output level follows the output video Keyer states. If a keyer does a cross fade, V fade, cut, etc., the audio in that Keyer follows. While disabled, the audio will operate independently of the Keyer. CMD j5 j5 Function %01x Follow 2 Param_1 %01x On/Off 1 or 0 void FollowDSK(int OnOff); { remote_send("j52%01x, OnOff); } Voice-over Follow Easyplay j53 Activates voice-over 1 whenever an Easyplay file is playing out.
Automation Protocol Audio Commands Preview selections are: Preview A Input Preview Value 0x00 B Input 0x01 A/B Mix 0x02 Voice Over 0x03 Voice Over Enabled 0x04 Program 0x05 Silence 0x06 Test Tone 0x07 2 Voice-over 0x08 Full A/B Mix 0x09 Preview selections for Imagestore 750 are: Preview Preview Value Embedded Input 0xFF A Input 0x00 B Input 0x01 A/B Mix 0x02 Voice Over Input 0x03 Voice Over Mix 0x04 Program 0x05 Silence 0x06 Test Tone 0x07 Passthrough 0x08 The com
Automation Protocol Audio Commands void SelectPreview(int Preview); { remote_send("j6%02x, Preview); } The preview output is AES only and is not embedded into the output video stream. Audio Enquire j7 The internal parameters and settings of Easysound can be interrogated for feedback and tracking purposes. All parameters are returned in a string containing a number of fixed-width parameters, without commas or other separating characters. The width of each parameter field is listed in the tables below.
Automation Protocol Audio Commands Format %02x %02x %02x Field Input Level Pair 2 Input Trim Pair 1 Input Trim Pair 2 Description dBval dBval dBval %02x Input Source Pair 1 0, 2, 4, 6 or 8 (Only returned for inputs 1 and 3) %02x Input Source Pair 2 %01x Phase Invert Pair 1 0, 2, 4, 6 or 8 (Only returned for inputs 1 and 3) 0 or 1 %01x %01x %01x Phase Invert Pair2 Input Mute Pair 1 Input Mute Pair 2 0 or 1 0 or 1 0 or 1 Enquiring Inputs (j70) now returns the 4-bit shuffle mask values for each
Automation Protocol Audio Commands Voice-over Voice-over 1 Pair 1 Voice-over 1 Pair 2 Voice-over Number 1 2 Voice-over 2 Pair 1 Voice-over 2 Pair 2 3 4 Enquire Outputs j72 Output parameters can be requested with the following example.
Automation Protocol Audio Commands Enquire Rates j73 Transition durations can be requested with the following example.
Automation Protocol Audio Commands { remote_send("j74"); } The information returned is: Format Field Description %c %c %c j 7 4 Audio Enquire Audio Follow %01x %01x Audio follow fade to black Audio follow A/B mix 0 or 1 0 or 1 Where 0 indicates that audio follow is inactive and 1 indicates that audio follow is active. Enquire Preview j75 Returns the current preview mode setting.
Automation Protocol Audio Commands Preview Mode Mix Voice-over 1 Pair 1 Voice-over 1 Pair 2 Return Value 2 3 4 Voice-over 2 Pair 1 Voice-over 2 Pair 2 Voice-over on 5 6 7 Program Copy Silence 8 9 For Imagestore 750: Preview Mode A Input B Input Return Value 0 1 A/B Mix Voice-over Input Voice-over Mix 2 3 4 Program Silence Test Tome 5 6 7 Passthrough 8 Enquire Clean Feed j76 Returns the current clean feed setting in the same form as the j75 command.
Automation Protocol Enquire Monitor Audio Commands j77 Returns the current monitor setting in the same form as the j75 command. CMD Function j7 %01x 7 void EnquireMonitor() { remote_send("j77"); } Enquire Output Gain j79 Returns the current output mode gain setting.
Automation Protocol Audio Commands Audio FX Send/Return and Data Paths FX Send Setup j8 Sets up the audio FX send and return paths, and any gain applied to the FX send path. CMD Param_1 Param_2 Param_3 Param_4 j8 %1x Enable %2x: FX Send mode. j8 0 = Disabled, 1 = Enabled See the tables below %2x: FX Return pair 4 = Pair1, 6 = Pair2 %2x: FX Send gain.
Automation Protocol Audio Commands Example void Set_FX_Send(bool Enable, int SendMode, int ReturnPair, float SendGain) { remote_send("j8%01x%02x%02x%02x", Enable, SendMode, ReturnPair, SendGain); } Audio Data Path Setup j9 Specifies that a particular audio pair contains a data-stream rather than simple PCM audio data. This is used to enable a data ‘pass-through’ for systems such as Dolby E and Dolby Digital.
Automation Protocol Audio Commands Enhanced AB Mixer Controls Various additional commands for controlling the Easysound AB audio mixer have been added to support Presmaster functions. These are documented here. Audio AB Position ja Directly sets up the ‘position’ of the AB mix fader. Used for T-bar control of AB mixer. CMD Param_1 ja %03x Mix position. 0 = Fader at B, 512 (or 0x200) = Fader at A Audio AB Mix Mode jb Switches between audio cross-fades and audio v-fades.
Automation Protocol Audio Commands Audio AB Fade to Position jd Like the audio AB position command (‘ja’) but allows a fade the specified position instead of just a cut. CMD Param_1 Param_2 jd %03x Mix position. 0 = Fader at B, 512 (or 0x200) = Fader at A %03x: Rate in fields. Audio A and B Fade Position je & jf These commands allow the two halves of the audio AB mixer to be controlled independently.
Automation Protocol Audio Commands Bit 0 - Channel Out 0 Bit 1 - Channel Out 1 Bit 2 - Channel Out 2 Bit 3 - Channel Out 3 For example a mask value of 10, 0xa or 1010b would connect output channels 1 and 3 to the specified input channel. This command should be used in preference to the j0 0 command which only permits one output channel to be connected to each input channel. Audio Clean Feed Select jh This command sets the clean feed audio monitoring point for Imagestore 750.
Automation Protocol Audio Metering Commands Audio Metering Commands Set Audio Metering Mode Y0 Specify audio metering mode, and specifies which mixes are to be metered. On start-up, metering defaults to off. Once metering is enabled, the audio Metering packets described below are sent on a regular basis. Metering of up to 4 pairs is supported, with each pair being selectable individually.
Automation Protocol Audio Metering Packet Audio Metering Commands Y0 An unsolicited packet, sent every frame or field when audio metering is enabled (see above) CMD Y0 Param_1 %8c: Metering values. These are all expressed in dB. Each byte represents a meter value from a single mono input. Param_1 is a string of 8 bytes, one for each output being metered All values all have the top bit set.
Automation Protocol Easytext Commands Dolby and Up-mix Commands Note: The Dolby and up-mix commands are applicable to Imagestore 750 v2.0 or above with the relevant Dolby or up-mix module fitted. See the Imagestore 750 user manual for more information. Set Up-Mix Mode q00 This command sets the operating mode of an up-mix module. CMD q0 Param_1 %1x: 0 Param_2 %1x: UpMix Module No.
Automation Protocol Easytext Commands Set Dolby Decoder Mode q30 This command sets the operating mode of a Dolby E encoder module. CMD q3 Param_1 %1x: 0 Miranda Technologies Ltd Param_2 %1x: Dolby Decoder Module No.
Automation Protocol Easytext Commands Metadata Commands Note: The metadata commands are applicable to Imagestore 750 v2.0 or above. See the Imagestore 750 user manual for more information. Note that these commands have a “Flags” parameter that are not yet used and are reserved for future use. The value “0” is currently to be used for this parameter for all commands.
Automation Protocol Easytext Commands The current program description can be enquired using: CMD Param_1 Param_2 o1 %1x: Bank No. %1x: Program No. The response is in the form of the set command. Set Program Bitstream Mode o2 This command sets the program bitstream mode to indicate the program service type: CMD Param_1 Param_2 Param_3 Param_4 o2 %1x: Bank No. %1x: Program No.
Automation Protocol Easytext Commands Set Program Audio Coding Mode o3 This command sets the program audio coding mode to indicate the main service channels in use: CMD Param_1 Param_2 Param_3 Param_4 o3 %1x: Bank No. %1x: Program No.
Automation Protocol Easytext Commands The current program centre down-mix level can be enquired using: CMD Param_1 Param_2 o4 %1x: Bank No. %1x: Program No. The response is in the form of the set command. Set Program Surround Down-Mix Level o5 This command sets the program nominal down-mix level of the surround channels: CMD Param_1 Param_2 Param_3 Param_4 o5 %1x: Bank No. %1x: Program No.
Automation Protocol Easytext Commands The current program Dolby surround mode can be enquired using: CMD Param_1 Param_2 o6 %1x: Bank No. %1x: Program No. The response is in the form of the set command. Set Program LFE Enable o7 This command sets the program Low Frequency Effects (LFE) enable: CMD o7 Param_1 %1x: Bank No. Param_2 %1x: Program No.
Automation Protocol Easytext Commands CMD Param_1 Param_2 o8 %1x: Bank No. %1x: Program No. The response is in the form of the set command. Set Program Production Mix Level o9 This command sets the program production mix level value: CMD Param_1 Param_2 Param_3 Param_4 o9 %1x: Bank No. %1x: Program No. %02x: Flags 00 %02: Mix Level (0 to 31) The current program production mix level can be enquired using: CMD Param_1 Param_2 o9 %1x: Bank No. %1x: Program No.
Automation Protocol Easytext Commands The response is in the form of the set command. Set Program Copyright Flag oB This command sets the program copyright flag for the information contained in the bitstream: CMD oB Param_1 %1x: Bank No. Param_2 %1x: Program No. Param_3 %02x: Flags 00 Param_4 %1: Copyright Flag 0 – Not copyright 1 – Copyright The current program copyright flag can be enquired using: CMD Param_1 Param_2 oB %1x: Bank No. %1x: Program No.
Automation Protocol Easytext Commands Set Program Down-Mix Mode oD This command sets the type of stereo program down-mix mode preferred by the master engineer. Note that this may be used, overridden or ignored: CMD Param_1 Param_2 Param_3 Param_4 oD %1x: Bank No. %1x: Program No.
Automation Protocol Easytext Commands The response is in the form of the set command. Set Program Down-Mix Lt/Rt Surround Mix Level oF This command sets the nominal program down-mix level of the surround channel with respect to the left and right channels on a left total/right total (Lt/Rt) down-mix: CMD oF Param_1 %1x: Bank No. Param_2 %1x: Program No. Param_3 %02x: Flags 00 Param_4 %02: Surround Mix Level 0 – –1.5dB 1 – –3dB 2 – -4.
Automation Protocol Easytext Commands The current program down-mix Lo/Ro centre mix level can be enquired using: CMD Param_1 Param_2 oG %1x: Bank No. %1x: Program No. The response is in the form of the set command. Set Program Down-Mix Lo/Ro Surround Mix Level oH This command sets the program down-mix level of the surround channels with respect to the left and right channels on a only/right only (Lo/Ro) downmix: CMD o Param_1 %1x: Bank No. Param_2 %1x: Program No.
Automation Protocol CMD oI Param_1 %1x: Bank No. Easytext Commands Param_2 %1x: Program No. Param_3 %02x: Flags 00 Param_4 %02: Dolby Surround EXTM mode 0 – Not indicated 1 – Not encoded 2 – Encoded The current program Dolby Surround EXTM mode can be enquired using: CMD Param_1 Param_2 oI %1x: Bank No. %1x: Program No. The response is in the form of the set command. Set Program Dolby Headphone Mode oJ This command sets whether the program has been Dolby headphone encoded.
Automation Protocol CMD oK Param_1 %1x: Bank No. Easytext Commands Param_2 %1x: Program No. Param_3 %02x: Flags 00 Param_4 %02: ADC Type 0 – Standard (or unknown) 1 – HDCD The current program A/D converter type can be enquired using: CMD Param_1 Param_2 oK %1x: Bank No. %1x: Program No. The response is in the form of the set command.
Automation Protocol Easytext Commands Set Program Low Pass Filter Enable oM This command sets the program Low Pass Filter (LPF) enable for the main input channels of the Dolby Digital encoder: CMD Param_1 Param_2 Param_3 Param_4 oM %1x: Bank No. %1x: Program No. %02x: Flags 00 %1: LPF Enable 0 – Disabled 1 – Enabled The current program LPF enable can be enquired using: Param_1 Param_2 %1x: Bank No. %1x: Program No. CMD oM The response is in the form of the set command.
Automation Protocol Easytext Commands Set Program Surround 90 Degree Phase-Shift oO This command sets the program surround channels 3dB attenuation enable: CMD oO Param_1 %1x: Bank No. Param_2 %1x: Program No. Param_3 %02x: Flags 00 Param_4 %1: 90 Degrees Phase Shift Enable 0 – Disabled 1 – Enabled The current program 90 degree phase shift can be enquired using: CMD Param_1 Param_2 oO %1x: Bank No. %1x: Program No. The response is in the form of the set command.
Automation Protocol Easytext Commands Set Program RF Pre-emphasis oQ This command sets the program radio frequency (RF) pre-emphasis for RF modulated Dolby Digital bitstreams: CMD Param_1 Param_2 Param_3 Param_4 oQ %1x: Bank No. %1x: Program No. %02x: Flags 00 %1: RF Pre-emphasis Enable 0 – Disabled (default) 1 – Enabled The current program RF pre-emphasis can be enquired using: CMD Param_1 Param_2 oQ %1x: Bank No. %1x: Program No. The response is in the form of the set command.
Automation Protocol Easytext Commands 4 5 Music-light Speech The current program compression profile/word can be enquired using: CMD Param_1 Param_2 oR %1x: Bank No. %1x: Program No. The response is in the form of the set command. Set Program Dynamic Range Value oS This command sets the program compression profile: CMD Param_1 Param_2 Param_3 Param_4 Param_5 oS %1x: Bank No. %1x: Program No. %02x: Word No.
Automation Protocol Easytext Commands Load Metadata Preset oT This command loads a metadata preset: CMD Param_1 Param_2 oT %1x: Bank No. %s: Metadata Preset Name The current metadata preset can be enquired using: CMD oT Param_1 %1x: Bank No. The response is in the form of the set command. Set Program Dynamic Range Type oU This command sets the program dynamic range type: CMD oU Param_1 %1x: Bank No. Param_2 %1x: Program No.
Automation Protocol Miranda Technologies Ltd Easytext Commands Page 214
Automation Protocol Easytext Commands Easytext Commands Introduction The Oxtel Series automation protocol supports control of the Easytext character generation software when the Easytext licence is present. Commands have been added to the Imagestore software to allow specification and formatting of on-screen text. Summary Easytext templates are built using the Textbuilder software application from the Media Conversion Software (MCS) suite.
Automation Protocol Easytext Commands The Z0 command is the basis for all text updates. All Easytext commands take a ‘layer’ parameter, defining whether the midground (preview) or foreground (program) image is being modified. In addition, many commands refer to a specific box on the template. Box numbers can range from 0 to 254 (0xFE). Box 255 (0xFF) is treated as a special case by some commands. International Character Set Support Easytext uses Unicode rather than ASCII to represent characters.
Automation Protocol Easytext Commands More Sophisticated Control of Easytext Additional commands allow automation systems to override parameters set in the template – changing font sizes and colours, and even altering text box positions on screen. Note: In order for one or more updated parameter, such as the text or an image for a particular box, to be rendered the “Render Box” command Z3 has to be sent.
Automation Protocol Easytext Commands Main Commands Update Text Field Z0 This command updates the text in a specified text box. Formatting and style of the text is unchanged. CMD Z0 Param_1 %01x Layer No. Param_2 %02x Text Box No. Param_3 %01x Render Param_4 %s String Example: void UpdateTextBox(int Layer, int BoxNo, int flags, char* String) { remote_send("Z0%01x%02x%01x%s", Layer, BoxNo, flags, String); } The layer value specifies which Imagestore keying layer10 is addressed.
Automation Protocol Easytext Commands Box (Z3) or Update Text Field (Z0) with ET_RENDER set. Imagestore Intuition does not use this bitwise flag so calls to Z0 will render immediately. If the ET_APPEND bit is set, then the text is appended to the current text. This allows arbitrarily long text data to be defined over several command packets.
Automation Protocol Easytext Commands If a box number of 255 (0xFF) is sent, then ALL boxes are re-rendered with their latest values. This is useful to guarantee that all boxes update simultaneously. .
Automation Protocol Easytext Commands Example: void ChangeFont(int Layer, int BoxNo, int Size, int Col, char *FontFileName) { remote_send("Z2%01x%02x%02x%06x%s", Layer, BoxNo, Size, Col, FontFileName); } The font name relates to the font filename to be used in the graphic. For example ‘Times New Roman’ must be addressed as ‘times.ttf’. The size is the ‘point size’ of the font. Note that points do not directly equate to pixels. The font’s design determines this.
Automation Protocol Easytext Commands Set Text Drop Shadow Z9 The drop shadow of the text can be adjusted with this command. CMD Z9 Param_1 %01x Layer No. Param_2 %02x Text Box No. Param_3 %02x X Offset Param_4 %02x Y Offset Param_5 %02x Trans.
Automation Protocol Easytext Commands The signed value should be ‘ANDED’ with 0xFFFF to ensure it is only four digits long. Example: void ChangeTextBgnd(int Layer, int BoxNo, int Tracking) { remote_send ("%01x%02x%04x", layer, BoxNo, Tracking & 0xffff); } Set Text Alignment ZE The alignment of text within a box can be adjusted with this command CMD ZE Param_1 %01x Layer No. Param_2 %02x Text Box No. Param_3 %01x Horiz. Align Param_4 %01x Vert.
Automation Protocol Easytext Commands Text Box Background Settings The following commands allow control of the backgrounds behind each text box. Set Text Background to Clear Z8 A coloured or gradient background may be removed with this command. CMD Z8 Param_1 %01x Layer No. Param_2 %02x Text Box No.
Automation Protocol Easytext Commands The transparency of the colour can be set with ‘trans’ where 0xFF is solid colour and 0x00 is transparent. The horizontal border and vertical border parameters describe the horizontal and vertical border placed around the colour block. Border values of 0 will produce a rectangle which fits behind the rendered text exactly. Values of 10 (0x0A) would produce a 10 pixel border outside the text rectangle.
Automation Protocol Easytext Commands The transparency of the box background can be set with ‘trans’ where 0xFF is solid colour and 0x00 is transparent. If the direction variable is 0, the gradient will be vertical; otherwise the gradient will be horizontal. The hborder and vborder define the width of the horizontal and vertical borders placed around the gradient colour block.
Automation Protocol Easytext Commands Text Straps Easytext supports text rolls and crawls, known together as straps. Additional commands give extra control of the playout of these. It is important to note that because the transition between ‘old’ and ‘new’ text happens at the wrapping point of the strap, there may be a significant delay between sending the text message, and having it displayed.
Automation Protocol Easytext Commands Enquire Crawl Count Loop Zc This command returns information about how many times a Crawl has looped. The loop count will be set to zero when a crawl is first loaded, or when the crawl is cut/faded up. CMD Zc Param_1 %01x Layer No. Example: void Enq_Crawl_Count_Loop(int Layer) { remote_send("Zc01x", Layer); } Imagestore Intuition requires an extra parameter “Box number” because there can be more than one crawl loaded into each layer.
Automation Protocol Easytext Commands Text Box Update Zd This command sends the Imagestore a remote Easytext command to update a text box within a specified loaded template. The command format is: CMD Zd Param_1 %01x Layer No. Param_2 %02x Box No. Parameter Layer No. Box No.
Automation Protocol Easytext Commands Image Update Ze This command sends the Imagestore a remote Easytext command to update an image within a loaded template. If a non-existent filename is supplied as Param_6, no action is taken. The command format is: CMD Ze Param_1 %01x Layer No. Param_2 %02x Box No. Parameter Layer No. Box No.
Automation Protocol Easytext Commands If a valid text box is found it returns with: Format %c%c %03x Field Cmd X Position Description Za In pixels %03x %03x %03x Y Position Width Height In pixels In pixels In pixels %02x %06x %02x Font Point Size Box Colour Transparency RGB 0 (Transparent) -255 (0xFF) (Solid) %04x %01x %01x Tracking Horizontal Alignment Vertical Alignment Font Tracking LEFT =0, CENTRE=1, RIGHT=2 TOP=0, CENTRE=1, BOTTOM=2 %02x %02x %02x Drop Shadow X offset Drop Shadow Y offse
Automation Protocol Easytext Commands Stop Animation Zf On Intuition units, animations occupy a template box rather than a full layer. The Zf command behaves exactly as the S1 command except that it includes a box number. CMD Zf Param_1 %01x Layer No. Param_2 %02x Text Box No. Param_3 %01x Complete Cycle Flag 0 = Complete cycle 1 = Stop immediately 2 = Complete cycle and restart (in-loopout animations only) Pause/Restart Animation Zg This command is used to pause or restart a roll or crawl.
Automation Protocol Easytext Commands The crawl count can be sent dynamically whilst the crawl is already in progress. If the new crawl count is less than the actual count, then the text crawl will end. The command format is: CMD Param_1 Param_2 Param_3 Param_4 Zh %01x Layer No %02x Box No. %04x New Crawl Count %01x: Auto cut down 1 = Strap should cut down after reaching maximum number of loops.
Automation Protocol Easytext Commands Datasources Datasources may be used to simplify delivery of textual information into Easytext-equipped systems. A datasource is a named tag embedded within the string of an Easytext box. Datasources can be created, modified or deleted under automation control. By updating the string value of the datasource dynamically, the string can be modified while it is on-air (either static or scrolling).
Automation Protocol Easytext Commands The advantage of using datasources with Easytext is that the process of delivering textual data can become entirely separated from the process of recalling slides that refer to it. For example, it is possible to have one PC feeding in a news headline summary into a datasource called ‘NEWS’, while another PC feeds stock ticker info into a datasource called ‘STOCKS’.
Automation Protocol Easytext Commands Datasource Automation Commands Set Global Datasource Value m0 This command assigns a new value to an external datasource. The format of the command is as follows: CMD m0 Param_1 %02x: Flags Param_2 %s: Name|Value The ‘Flags’ value gives a means of sending long strings by concatenation. Bit 0 = 1: Set for the FIRST packet, clear for all others Bit 1 = 1: Set for the LAST packet, clear for all others.
Automation Protocol Easytext Commands Delete Global Datasource m1 This command deletes a global datasource, freeing up any memory used for it. CMD Param_1 m1 %s: Datasource Name Set Layer-Specific Datasource Value m2 This command assigns a new value to an external datasource associated with a specific layer. The format of the command is as follows: CMD m2 Param_1 %02x: Flags Param_2 %02x: Layer No. Param_3 %s: Name|Value The ‘Flags’ value gives a means of sending long strings by concatenation.
Automation Protocol Easytext Commands The information returned is a list of the names of all the global datasources available, separated by a ‘|’ . If datasources ‘Name_1’ to ‘Name_n’ are set the response will be: Format %c%c %s Field Cmd Name_1|Name_2|….Name_n Description m4 List of global datasource names, or a blank string if there are no global datasources The global datasources can be set using the m0 command, and deleted using the m1 command.
Automation Protocol Easytext Commands The information returned is a list of the names of all the global datasources available, separated by a ‘|’ . If datasources ‘Name_1’ to ‘Name_n’ are set the response will be: Format %c%c %1x Field Cmd Layer No. Description m4 Layer number %s Name_1|Name_2|….Name_n List of datasource names for that layer, or a blank string if there are no datasources for that layer The layer-specific datasources can be set using the m2 command, and deleted using the m3 command.
Automation Protocol Easytext Commands Internal Datasources Internal datasources cannot be overridden or deleted: This is a list of internal datasources in the version of software, along with any parameters TIME Returns the current time of day. The option ‘FORMAT’ determines the format. All characters in the format are copied to the output, except the following ones, which are interpreted to insert time information i h H M S Insert hours - 12 hour clock, leading zeroes.
Automation Protocol Easytext Commands DATE The option ‘FORMAT’ determines the format. All characters in the format are copied to the output, except the following ones which are interpreted to insert date information D Insert day of the month - leading zeroes d Insert day of the month - no leading zeroes M Insert month number - leading zeroes m Insert month number – no leading zeroes Y Insert year number – 4 digits y Insert year number – last 2 digits W Insert full name of day of week (e.
Automation Protocol Easytext Commands IP_ADDR Returns the Ethernet IP address of the unit. SERIAL Returns the serial number of the unit.
Automation Protocol MPEG Commands MPEG Commands Note: The following commands only apply to the Imagestore 3 with the MPEG hardware decoder option. MPEG Control v0 The v0 command is used to control the MPEG Play-out card in Imagestore 3.
Automation Protocol Miranda Technologies Ltd EAS Commands Page 244
Automation Protocol EAS Commands EAS Commands EAS On n1 Brings to air in the Foreground/Program keyer an EAS crawl with the specified priority (see command n4) and with the specified text (see command n3). CMD n1 Example: n1 EAS Off n2 Whilst an EAS crawl is on air, this command restores the previously loaded image back to the Foreground/Program keying layer. CMD n2 Example: n2 EAS Set Text n3 This command is used to set the text that will be displayed in the next EAS crawl.
Automation Protocol EAS Commands The text "This is an EAS crawl" is saved to the EAS crawl file specified by the current priority. The next time that the EAS On (n1) command is received, this text will be displayed. Note: After using the ‘n3’ command, it is recommended to wait for three (3) seconds before issuing the EAS On (n1) command. This is to allow the Imagestore to store the text that has been set.
Automation Protocol Passive Mode Commands Passive Mode Commands Passive mode is a mode of operation where the Imagestore will transmit its internal state via the automation port when something has changed. In this mode, the amount of polling required by external automation devices will reduce, as it enables them to listen to the Imagestore tallies to always have an accurate image of the system status. Set Passive Mode On/Off Ya This command switches passive mode on or off within the Imagestore.
Automation Protocol Passive Mode Commands Layer Rate Yc This tally is issued by the Imagestore 2/3 in passive mode whenever one of the layer fade or fade-to-black rates changes on the Imagestore.
Automation Protocol Scheduled Commands Scheduled Commands This feature allows the user to specify the time and frame number an automation command is to be executed. Add Scheduled Command i0 This command schedules an automation command at a specified time up to 23 hours in the future.
Automation Protocol Scheduled Commands Timecode The time is referenced to the currently selected timecode source, VITC or LTC and is formatted as an 8 digit number HHMMSSFF, where: HH = Hours MM = Minutes SS = Seconds FF = Frames 00 – 23 00 – 59 00 – 59 00 – 29 Commands can be scheduled for any time up to 23 hours in advance and midnight crossing is supported. Note: If no timecode source is present the scheduler will not operate correctly.
Automation Protocol Scheduled Commands Time Of/Till Next Event i3 This command enquires the time of the next command, or the time until the next command CMD i3 Param_1 %01d: Flag 0=Timecode of next scheduled event, 1= Time until the next scheduled event The response is: CMD i1 Param_1 %01d Flag Param_2 %08d Timecode Scheduled commands are NOT saved therefore powering off the Imagestore will clear the scheduled list. If the video standard is changed, the scheduled list will be cleared.
Automation Protocol Miranda Technologies Ltd Scheduled Commands Page 252
Automation Protocol Scheduled Commands IntuitionXG Commands Note: The following commands only apply to the IntuitionXG. Note that a space separates the command and the first parameter. The “|” character is use to separate each parameter from the next parameter in the command. Cue V0 This sets a template to be cued onto a IntuitionXG keyer, which can be identified using the keyer number, or the keyer name that is used in Xplay.
Automation Protocol CMD V1 Clear Scheduled Commands Param_1 %s, %s, … Keyer Numbers or Keyer Names in Xplay, separated by commas Param_2 - Optional |%x Take Number -1 – Do all takes (default) 0 – do first take 1 – do second take … V2 This causes items that are on air on IntuitionXG keyers to be cleared. The keyers can be identified using the keyer number, or the keyer name used in Xplay. Multiple keyers are separated by the ‘,’ character and can be cleared using one command.
Automation Protocol CMD V4 Scheduled Commands Param_1 %s, %s, … Keyer Numbers or Keyer Names in Xplay, separated by commas Set Property Param_2 |%x Fade Rate 0 – Cut Fade Rate in mS Param_3 - Optional |%x Output 0 – Preview 1 – On air V5 This allows properties to be set on IntuitionXG. For example the text or image to be used within one or more template on one or more keyer can be set. The property can be set to be changed on the preview or on air.
Automation Protocol Scheduled Commands Enable IntuitionXG Tallies V8 This enables or disables IntuitionXG tallies.
Automation Protocol Miscellaneous Commands Miscellaneous Commands Image Count Ra This command returns how many images are used on the Imagestore 2/3 system and the maximum available. CMD Ra The response is in the form: CMD Param_1 Param_2 Ra %04x Number of images currently used %04x Maximum number of images Pixel Count Rb Command 'Rb' responds with the total number of pixels in an animation on an Imagestore 2/3 or Imagestore HD-TV.
Automation Protocol Miranda Technologies Ltd Appendix A – Command Validity Page 258
Automation Protocol Appendix A – Command Validity Appendix A Command Validity In the following please note that a number indicate the version number in which the command was introduced. X X X X X X X Xa X X X X X X X X X X X Miranda Technologies Ltd X X X X 4.0 4.0 4.2 4.0 X X X X 4.0 4.2 LGK-3901 X X X X X X X X X X X X 4.
Automation Protocol Appendix A – Command Validity X X X X X X X X 4.0 1.14.1 1.14.1 1.14.1 X l 2.1 2.1 2.1 1.14.1 m0 m1 m2 m3 m4 m5 m6 m7 m8 R0 R1 R2 R3 R4 R5 R6 R7 R8 R9 LGK-3901 a b c d e f g h X DSK-3901 X X X Imagestore 750 Imagestore 300[+]/HD-TV X X X IntuitionXG Imagestore 2/3 O P Q Intuition[+] Command X X 1.13.8 1.13.8 1.13.8 1.13.8 1.13.8 1.13.8 1.13.8 X X 1.13.8 1.13.8 1.13.8 1.13.8 1.13.8 1.13.8 1.13.8 4.2 X X X X X X X X X X X X X X X X X 4.
Automation Protocol 1.14.1 LGK-3901 4.2 DSK-3901 X 4.0 Imagestore 750 X IntuitionXG Rm RA Intuition[+] Imagestore 300[+]/HD-TV Imagestore 2/3 Command Appendix A – Command Validity 2.1 RB 2.27 1.13.8 2.0.1 S0 S1 S2 S3 S4 X X X X X X X 4.0 4.0 4.0 1.14.1 1.14.1 1.14.1 2.1 2.1 2.1 X 4.0 1.14.1 2.1 T0 T1 T2 T3 X X X X X X X X 1.14.1 1.14.1 1.14.1 1.14.1 2.1 2.1 2.1 2.
Automation Protocol X X X LGK-3901 k0 k1 k2 DSK-3901 X X X X X X Imagestore 750 W0 W1 W2 W3 W4 W5 W7 W8 WP WR IntuitionXG X X Intuition[+] Imagestore 2/3 v0 v1 Imagestore 300[+]/HD-TV Command Appendix A – Command Validity i0 X X 1.14.1 2.1 2.1 i1 X X 1.14.1 2.1 2.1 i2 X X 1.14.1 2.1 2.1 i3 X X 1.14.1 2.1 2.1 1.14.1 2.1 2.1 1.14.1 1.14.1 1.14.1 2.1 2.1 2.1 2.1 X X 1.14.1 1.14.1 X X 1.14.1 1.14.1 1.14.1 1.14.1 X X X 1.14.1 1.14.1 1.14.1 k3 X 1.14.
Automation Protocol X X X X Xe 4.0 LGK-3901 Xm X X X DSK-3901 X X Imagestore 750 X X X X X X X X X X X X Xi X X IntuitionXG X X Intuition[+] Imagestore 300[+]/HD-TV X9 XA XB XC XE XH XI XJ XK XL XM XN XP XR XS XT XU XV XX Xc Imagestore 2/3 Command Appendix A – Command Validity 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 3.0 1.14.1 2.1 2.1 2.1 2.1 2.1 2.1 2.1 2.1 2.1 2.1 2.1 2.1 2.1 2.1 2.1 2.1 2.1 2.1 2.
Automation Protocol 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 X X X X Miranda Technologies Ltd LGK-3901 X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X DSK-3901 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.
Automation Protocol o0 o1 o2 o3 o4 o5 o6 o7 o8 o9 oA oB oC Miranda Technologies Ltd X X X X X X X X LGK-3901 X X X X X X X X X DSK-3901 X Imagestore 750 X X X X IntuitionXG X X X X Intuition[+] Imagestore 300[+]/HD-TV j72 j73 j74 j75 j76 j77 j78 j79 j8 j9 ja jb jc jd je jf jg jh ji jl Imagestore 2/3 Command Appendix A – Command Validity 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.141. 2.0.1 2.0.1 2.0.1 2.0.1 2.
Automation Protocol 2.0.1 2.0.1 2.0.1 2.0.1 2.0.1 2.0.1 2.0.1 2.0.1 2.0.1 2.0.1 2.0.1 2.0.1 2.0.1 2.0.1 2.0.1 2.0.1 2.0.1 2.0.1 q0 q1 q2 q3 2.0.1 2.0.1 2.0.1 2.0.1 Y0 Y1 Y3 Y6 Y7 Y8 Y9 X X X X X X X X X X X X X X YA X YB 1.13.8 YD Miranda Technologies Ltd X X 4.0 4.0 X 1.13.8 4.2 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.
Automation Protocol Intuition[+] X X X X 4.0 2.1 2.1 1.14.1 2.1 2.1 Yf LGK-3901 1.14.1 4.0 X DSK-3901 Ya Yb Yc Yd Ye Imagestore 750 Imagestore 300[+]/HD-TV X X X X X YO IntuitionXG Imagestore 2/3 Command Appendix A – Command Validity 1.14.1 2.1 2.1 1.14.1 2.1 2.1 Yg 1.13.8 Yj 1.13.8 1.14.1 3 (tally) X 1.14.1 2.1 2.1 2.1 Z0 Z1 Z2 Z3 Z4 Z5 X X X X X X X X X X X X X X X X X 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 1.14.1 2.1 2.1 2.1 2.1 2.1 2.
Automation Protocol X X X X LGK-3901 DSK-3901 X V0 V1 V2 V3 V4 V5 V8 Ra Rb Imagestore 750 n1 n2 n3 n4 IntuitionXG Zh Intuition[+] Imagestore 300[+]/HD-TV Imagestore 2/3 Command Appendix A – Command Validity 2.1 X X X X 1.14.1 1.14.1 1.14.1 1.14.1 2.1 2.1 2.1 4.2 4.2 4.2 4.2 4.2 4.2 4.2 X X 2.
Automation Protocol Appendix B – Layer Numbers Appendix B Layer Numbers Imagestore IS1 & Imagestore IS2 Swap / Preview Mode Cascade Mode 0 for preview layer, 1 for program layer 0 for midground layer, 1 for foreground layer Imagestore Upstream 0 for preview layer, 1 for program layer Imagestore 300[+] & Imagestore HD-TV 0 = Keyer 1 (DSK1) 1 = Keyer 2 (DSK2) Intuition[+] 0 – f = Layers 1 to 16.
Automation Protocol Appendix B – Layer Numbers LGK-3901 0 = Keyer 1 (DSK1) 1 = Keyer 2 (DSK2) 2 = Keyer 1 (DSK3) 3 = Keyer 2 (DSK4) 4 = Keyer 2 (DSK5) The LGK-3901 has three stores, that can be assigned to any three keyers. See the Xi command for more details.
Automation Protocol Appendix C – CRC Generation Appendix C CRC Generation The following C example demonstrates simple codes to format and send messages to an Imagestore. Imagestore status returns and acknowledges are ignored. // Note these codes bear no relation to the ASCII defined codes with similar names.
Automation Protocol Appendix C – CRC Generation char message[128]; char* messageptr = (char*)message; va_list argptr; va_start(argptr, format); vsprintf(message, format, argptr); va_end(argptr); rem_send_char(stx); while((ch = *messageptr++) != 0) { rem_send_char(ch); do_crc(ch, &rem_crc); } rem_send_char(':'); do_crc(':', &rem_crc); rem_send_char(rem_crc & 0xff); rem_send_char(rem_crc >> 8); if (stx == STX0) stx = STX1; else stx = STX0; } Miranda Technologies Ltd Page 272
Automation Protocol Appendix D – Automation Examples Appendix D Automation Examples Whilst it is all very well to have a list of automation commands, individual commands are often only useful when used in conjunction with other related commands. It is the job of automation to sequence automation commands at appropriate time intervals to achieve the desired on-air effects. This chapter therefore lists some basic sequences of automation commands to illustrate some basic video operations.
Automation Protocol U603: U5078: UD000000: U8028050: Appendix D – Automation Examples // // // // // // Set AB transition type: X-fade Fade AB over 120 fields Wait Set V-fade colour to black V-fade AB over 40 fields then 80 fields DVE Moves The following example brings the DVE in circuit, and then loads and plays DVE sequence number 10 forwards over its default duration.
