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

QMed_ExportAreaMovie Exports the image from a QMedical plug-in area to a movie
QMed_DoExportMovieSettingsDlg Displays the movie export settings dialog for a specific movie type

QMedical © Escape
Generated by QDoc 2.8 on Wed, Jan 27, 2010 17:54:38