QMedia Grabber area commands


QM_GetMaxGrabberOutputSize(areaRef; maxKilobytes):error
areaRef Longint Grabber area reference
maxKilobytes Longint Maximum output size in KB
error Longint Error result

Returns the maximum size of the grabber output file.

When the sequence grabber starts a recording operation, first it tries to allocate a file as large as possible on the destination disk. This is done in order to avoid incrementing the size of the file during recording, and thus avoid delays and dropped frames.

While this is not a problem for most cases, when recording to very large disks there may be a noticeable delay when the recording operation is started. The only way to avoid this delay, is to tell the sequence grabber the maximum size of the recorded movie. Then the sequence grabber will allocate a file of that size at maximum, regardless of the size of the destination disk.

The grabber plug-in area is specified by areaRef.

Parameter maxKilobytes receives the maximum size of the captured file. This value is expressed in kilobytes (1 kilobyte = 1024 bytes). By default the maximum size is set to -1, which means that there is no limit for the captured file size.

Related commands

QM_SetMaxGrabberOutputSize Specifies the maximum size of the grabber output file

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