QPx_ExportPicture

QPx_ExportPicture(pictVar; pictVar; pictVar; pictVar; pictVar):error
	pictVar	Picture	Picture variable
	targetPath	Text	Pathname to the target file
	targetType	Text	4-char image type identifier
	exportSettings	BLOB	Export settings
	exportOptions	Longint	Export options (optional)
	error	Longint	Error result

The source picture is passed in the pictVar parameter.

The target (destination) file is specified by targetPath. The target file need not 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 "TIFF". 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 (qpx_ParamErr). If the user cancels the dialog, error qpx_userCancelErr is returned.

To get the list of avaliable export formats, call the QPx_GetExportTypes command. QPix defines the following constants for the export formats supported by QuickTime:

The exportSettings parameter can be used to specify format-specific settings for the export operation, and to receive settings after a successful image export. Not all export formats support settings. If the specified export format does not support settings, this parameter is ignored. 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 known as a QuickTime Atom Container and cannot be easilly parsed, constructed, or altered with 4D BLOB commands. Normally you let the user modify the export settings by calling the QPx_DoExportSettingsDialog high-level command. To fiddle with the settings BLOB, use the plug-in QTAtoms.bundle that is included in the QPix distribution package.

The exportOptions parameter is optional. The following constant is supported.

Example

   // Export a 4D picture to TIFF

C_LONGINT($error)
C_PICTURE($picture)
C_TEXT($destPath)
C_BLOB($settings)

$picture:=[Images]Picture
$destPath:="Macintosh HD:Image.tiff"

$error:=QPx_ExportPicture ($picture;$destPath;qpx_TIFFFile;$settings)

If ($error#qpx_noErr)
   
      // Handle the error
   
End if 

Related commands