QPx_DoExportSettingsDialog

QPx_DoExportSettingsDialog(exportType; exportSettings):error
exportType String4 Export type
exportSettings BLOB Export settings
error Longint Error result

Displays the export settings dialog for a specific file type, and allows the user to set the export parameters.

Parameter exportType specifies the export file type.

The exportSettings parameter specifies settings for the export dialog, and receives updated settings after the user accepts the dialog. Not all export formats support settings dialogs. If the specified export format does not support settings dialogs, the command returns error qpx_badCompSel.

Note: The structure of this BLOB is known as a QuickTime Atom Container. This BLOB cannot be easilly parsed, constructed, or altered with 4D BLOB commands. If you really want to fiddle with the settings BLOB, you will find the QTAtoms plug-in handy. QTAtoms.bundle is included in the QPix distribution package.

To get the list of avaliable export formats, call the QPx_GetExportTypes command. See the file formats section for a list of QPix constants.

Example

  `Display the TIFF export settings dialog, and export
  `a picture with the specified settings
 
C_LONGINT($error)
C_PICTURE($picture)
C_BLOB($settings)
C_TEXT($destPath)
 
$error:=QPx_DoExportSettingsDialog(qpx_TIFFFile;$settings)
 
If ($error=qpx_noErr)
 
  $picture:=[Images]Picture
 
  $destPath:="Macintosh HD:image.tiff"
 
  $error:=QPx_ExportPicture ($picture;$destPath;qpx_TIFFFile;$settings)
 
End if
 

Related commands

QPx_GetExportTypes Returns the list of available export types

QPix © Escape
Generated by QDoc 2.8 on Wed, Feb 17, 2010 17:45:58