QM_SetGrabberOutput

QM_SetGrabberOutput(areaRef; movieFile):error
	areaRef	Longint	Grabber area reference
	movieFile	Text	Output movie file
	error	Longint	Error result

Changes the output file of a grabber plug-in area.

The grabber plug-in area is specified by areaRef.

Parameter movieFile is the full pathname to the movie file where the grabber will store captured data on the next recording session. The specified file may not already exist, but its containing folder path must be valid. If movieFile points to an existing file, the later will be replaced by the new movie file.

If movieFile is empty, QMedia presents the standard file saving dialog where the user can select the location and type the name of the new movie file. If the user cancels the dialog, error qm_userCancelErr is returned, otherwise parameter movieFile receives the full pathname of the new movie file.

This command cannot be called during a recording session.

Example

C_TEXT($path)

$path:="C:\video.mov"

$error:=QM_SetGrabberOutput (xGrabber;$path)

Related commands

QM_GetGrabberOutput

Returns the grabber's output file.