Grass Valley K2 Edge Protocol Manual v1.0 - Manual (Page 18)

K2 Edge Protocol Manual – document version 1.0 – Page 18
4.12. Sub command sg-select
Function: selects a previously preloaded scene graph waiting in the preload queue as the target for
incoming NRE commands.
field name field type
value
cmd mandatory nre
subcmd mandatory sg-select
exid mandatory External ID. Free format. See above.
rootfolder mandatory Path to channel pack as used in sg-preload, OR the reserved
keyword next.
If a path is specified, the scene graph preload queue is scanned for
a scene graph preloaded from exactly that path, and if found the
scene graph is (a) selected as the current target for incoming NRE
commands, and (b) removed from the preload queue.
If the keyword next is specified however, the scene graph waiting
at the front of the preload queue (if any) is (a) selected as the
current target for incoming NRE commands, and (b) removed from
the preload queue.
sg-inst mandatory when path
is specified for
rootfolder field.
Unique scene graph instance ID as was specified with the
corresponding sg-preload sub command.
stm optional Start time for the command in hh:mm:ss:ff timecode format. When
not specified, the command starts as soon as possible.
role optional Role field. See above. Note that only schedule roles are allowed
to use this sub command.
Notes:
• Please paragraph 4.7 for an explanation of selected and active scene graphs.
• Only a scene graph previously preloaded with sg-preload and still waiting in the preload queue
can be selected as the new target for incoming NRE commands.
• Once selected, the scene graph is removed from the preload queue, and thus cannot be selected
again without another sg-preload.
• Selecting a scene graph that cannot be found in the preload queue has no side effects.
Examples:
{cmd=nre; subcmd=sg-select;
rootfolder=/publitronic/objects/channelpack/music;
sg-inst=15; exid=4; stm=14:08:10:00;}
{cmd=nre; subcmd=sg-select; rootfolder=next; exid=5; stm=14:08:10:00;}