QMedia Grabber area commands

QM_SetMaxGrabberOutputSize

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

Specifies 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. By default the size of the grabber output file is not limited.

The grabber plug-in area is specified by areaRef. This command affects all future recording operations with the specified grabber plug-in area.

Parameter maxKilobytes specifies the maximum output file size. This value is expressed in kilobytes (1 kilobyte = 1024 bytes). To remove any limit previously set with this command, set maxKilobytes to -1 which means no limit.

Related commands