QMedia Movie properties commands

QM_SetActiveSegment

QM_SetActiveSegment(movieRef; activeSegStart; activeSegDuration):error
movieRef Longint Movie reference
activeSegStart Longint Active segment start
activeSegDuration Longint Active segment duration
error Longint Error result

Changes the active segment of a movie.

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

Parameter activeSegStart specifies the starting point of the movie's active segment.

Parameter activeSegDuration specifies the duration of the movie's active segment.

Both activeSegStart and activeSegDuration must be expressed in the movie's time scale.

If activeSegStart is -1, the entire movie is made active. In that case the activeSegDuration parameter is ignored.

Example

  `Set the active segment of movie $movieRef to half the movie duration
 
C_LONGINT($duration)
$error:=QM_GetDuration ($movieRef;$duration)
 
C_LONGINT($activeStart;$activeDuration)
$activeStart:=0
$activeDuration:=$duration/2
 
$error:=QM_SetActiveSegment ($movieRef;$activeStart;$activeDuration)
 

Related commands

QM_GetActiveSegment Returns the active segment of a movie.

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