QMedia Annotation commands

QM_SetTrackAnnotation

QM_SetTrackAnnotation(movieRef; trackID; annType; annText):error
movieRef Longint Movie reference
trackID Longint Track ID
annType String4 Annotation type
annText Text Annotation text
error Longint Error result

Changes a text annotation in a track. If the specified annotation does not exist, it is created.

Parameter movieRef is the reference to the movie instance. The movie reference must have been previously obtained with a call to QM_NewMovieFromFile.

Parameter trackID is the ID of the track.

Parameter annType specifies the annotation type. For a list of QMedia constants for specifying common annotation types, see the QM_GetMovieAnnTypes command.

Parameter annText is the annotation's text.

Example

 `Set the track's comment
 
C_TEXT($comment)
$comment:="This is a comment"
$err:=QM_SetTrackAnnotation ($movie;$trackID;qm_CommentAnn;$comment)
 

Related commands

QM_GetTrackAnnTypes Returns the annotation types of all annotations present in a track.
QM_GetTrackAnnotation Returns a text annotation from a track.

QMedia © Escape OE
Generated by QDoc 2.8 on Thu, Nov 24, 2011 18:43:16