QMedia Grabber area commands |

### 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.

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