GETSEGMENT setref|* ; segref|segid ; attr1 ; attr2 ; …

STx 3.9 Documentation

Usage:

setref	The audio set reference (IREF or XML position) or an asterisk for the currently selected audio set.
segref	The reference to a segment inside the audio set.
segid	The ID of a segment inside the audio set.
attrX	The name of attribute to be retrieved. Note that multiple attributes can be retrieved. By default, the ID of the segment is returned.

Result:

empty string on error or requested attribute values (separated by semi-colons if more than 1)

Description:

Retrieve attributes of the specified segment. The table below shows the available attribute names.

attrX	return value	description
ID or NAME	'segid'	unique segment id
IREF	'segref'	internal reference of segment
SEGMENT [unit]	'begin_end'	segment expression
POSITION [unit] or BEGIN [unit]	'begin'	begin address of segment
END [unit]	'end'	end address of segment
LENGTH [unit]	'length'	length (duration) of segment
CHANNEL	'ch'	channel index of segment or '*' if segment is assigned to all channels
userattr	'uservalue'	value of userdefined attribute 'userattr'

notes:

if the segment was found, the database position is set to the segment element
to select the database element of a segment, an empty attribute list can be used
if an empty attributelist is used, the result is set to '*' to indicate success
the possible address units are SAMPLES, MILLISECONDS (=MS), SECONDS (=S) and HMS (hours:minutes:seconds.milliseconds)