r125: This commit was manufactured by cvs2svn to create tag 'r1_1_7-last'.
[cinelerra_cv/mob.git] / hvirtual / quicktime / docs / positioning.html
blobc5ab359d9f4fc19688fe1d73c577b77e2b84bebb
1 <TITLE>Positioning</TITLE>
3 <H1>Positioning yourself in a file</H1>
5 The library stores a seperate position identifier for each video track
6 and each audio track in a file. The position identifiers are
7 independant of each other and advance independantly when you read
8 data. Video tracks advance independantly, but audio tracks are
9 tricky. When you read audio data, the channel positions are not
10 independant. Since all the channels are on track 0, reading audio data
11 advances all the channel positions. You need to manually set the audio
12 position every time you want to read a different audio channel.<P>
14 There is no positioning support while writing because this is write-only.<P>
16 The positioning routines are as follows:<P>
18 <CODE>
19 int quicktime_seek_end(quicktime_t *file);<BR>
20 int quicktime_seek_start(quicktime_t *file);<BR>
21 int quicktime_set_audio_position(quicktime_t *file, long sample, int track);<BR>
22 int quicktime_set_video_position(quicktime_t *file, long frame, int track);<BR>
23 </CODE>
24 <P>
26 The seek_end and seek_start seek all tracks to their ends or starts.
27 The set_position commands seek one track to the desired position. The
28 track parameter for audio is always going to be 0.<P>