QMedia Video media commands |

### QM_AddVideoMediaPicture

QM_AddVideoMediaPicture(movieRef; trackID; sampleTime; sampleDuration; pictSample):error
| movieRef | Longint | Movie reference
| trackID | Longint | Track ID
| sampleTime | Longint | Sample time
| sampleDuration | Longint | Sample duration
| pictSample | Picture | Picture sample
| error | Longint | Error result

Adds a picture to a video track.

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 video track.

Parameters sampleTime and sampleDuration specify the insertion point and duration of the video sample. Both must be expressed in the movie's time scale. If sampleTime is -1, the video sample is added to the end of the track. In that case, parameter sampleTime also receives the actual time at which the sample was added.

Parameter pictSample is a picture variable.

Example

``Append a picture to video track ID $trackID` `` `C_PICTURE($samplePict)` `C_LONGINT($sampleTime;$sampleDuration)` `` `$samplePict:=[Slides]Image` `$sampleTime:=-1 `Append` `$sampleDuration:=[Slides]Duration` `` `$err:=QM_AddVideoMediaPicture ($movie;$trackID;$sampleTime;$sampleDuration;$samplePict)` ``

Related commands

QM_AddVideoMediaImage | Adds an image file as a sample to a video track.
QM_SetVideoMediaBackColor | Changes the background color of new video samples.
QM_SetVideoMediaDisplayFormat | Changes the display format of new video samples.
QM_SetVideoMediaCompression | Changes the compression options of new video samples.

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