
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.
cmd
mandatory nre
External ID. Free format. See above.
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.
is specified for
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 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;}
Comentarios a estos manuales