quicktime.std.sg
Interface SGDataProc
- public interface SGDataProc
The sequence grabber calls your data function whenever any channel component
writes data to the destination movie. You may use your data function to store the digitized data in some format other than a QuickTime movie.
Method Summary |
int |
execute(SGChannel chan,
QTPointerRef dataToWrite,
int offset,
int chRefCon,
int time,
int writeType)
The method that is called by QuickTime to write the provided data. |
execute
public int execute(SGChannel chan,
QTPointerRef dataToWrite,
int offset,
int chRefCon,
int time,
int writeType)
throws QTException
- The method that is called by QuickTime to write the provided data.
If any error occurs that should be provided back to quicktime this method should
throw an exception with the appropriate error number.
The method returns information to QuickTime
supplying the value indicated by the writeType parameter - typically where you wrote the data (or zero if you didn't write data).
- Parameters:
chan
- Identifies the channel component that is writing the digitized data. This will be
a subclass of the SGChannel abstract class.dataToWrite
- contains the digitized dataoffset
- may specify where you are to write the digitized datachRefCon
- contains control information - sample flags for use by the Movie ToolboxÕs AddMediaSample functiontime
- Identifies the starting time of the data, in the channelÕs time scale. You can use the SGChannel.getTimeScale method to retrieve the channel's time scale.writeType
- Indicates the type of write operation being performed.
- seqGrabWriteAppend
Append the new data to the end of the file. Set the field referred to by the offset parameter to reflect the location at which you added the data.
- seqGrabWriteReserve
Do not write any data to the output file. Instead, reserve space in the output file for the amount of data indicated by the len parameter. Set the field referred to by the offset parameter to the location of the reserved space.
- seqGrabWriteFill
Write the data into the location specified by the field referred to by the offset parameter. Set that field to the location of the byte following the last byte you wrote.
- Returns:
- where you wrote the data or zero if you didn't write data.