QMedia Grabber area commands

QM_GetMaxGrabberOutputSize

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