QMedical Command Reference Area Image

QMed_ExportAreaMovie

QMed_ExportAreaMovie(areaRef; targetPath; movieType; exportSettings):error
	areaRef	Longint	QMedical area reference
	targetPath	Text	Pathname to the target file
	movieType	String4	4-char movie type
	exportSettings	BLOB	Export settings
	error	Longint	Error result

Exports the image from a QMedical plug-in area to a movie file.

The QMedical plug-in area is specified by areaRef. If areaRef is not a valid QMedical plug-in area reference, qmed_paramErr is returned.

The target (destination) file is specified by targetPath. The target file may not already exist, but its containing folder path must be valid. If targetPath points to an existing file, the latter will be replaced by the new file. If targetPath is empty, a file selection dialog is presented for the user to select the target directory and specify a file name.

The targetType parameter specifies the target file format. If targetPath is specified and targetType is passed an empty string, targetType defaults to "MooV". If targetPath is not specified, both the target path and type will have to be selected from the file selection dialog. In any other case, an error will be generated (qmed_ParamErr). If the user cancels the dialog, error qmed_userCancelErr is returned.

Currently only QuickTime and AVI movies can be exported. To export to a QuickTime movie, set targetType to "MooV". To export to an AVI movie, set targetType to "VfW " (note the space at the end).

The exportSettings parameter specifies format-specific settings for the export operation, and receives the settings after a successful movie export. If an empty BLOB is passed, format-specific defaults are used.

Note: The exportSettings BLOB parameter must contain valid export settings. The structure of this BLOB is private to QuickTime and cannot be constructed or altered with 4D BLOB commands. To let the user modify the export settings, call the QMed_DoExportMovieSettingsDlog command.

Related commands