QPx_DoExportSettingsDialog

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

Display the export settings dialog for a specific file type

Parameter exportType specifies the export file type.

Parameter exportSettings 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 and cannot be easilly parsed, constructed, or altered with 4D BLOB commands. To fiddle with the settings BLOB, use the plug-in QTAtoms.bundle that is included in the QPix distribution package.

To get the list of avaliable export formats, call the QPx_GetExportTypes command (and file format 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_ExportImageFile Save an image file in another file format
QPx_ExportPicture Save a picture variable in an image file
QPx_ExportImporterImage Export the image associated with an importer to file in a specified format
QPx_GetExportTypes Get the list of available exporters