QMedical Command Reference Images

QMed_ExportMovie

QMed_ExportMovie(imageRef; targetPath; movieType; exportSettings):error
	imageRef	Longint	Reference to the image
	targetPath	Text	Pathname to the target file
	movieType	String4	4-char movie type
	exportSettings	BLOB	Export settings
	error	Longint	Error result

Exports an image to a movie.

The image is specified by imageRef. If imageRef is not a valid image, error 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.

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