QPix Command Reference
![]() |
![]() |
QPx_ExportImporterImageToBLOB(importerRef; targetBlob; targetType; exportSettings):error | |||
![]() |
importerRef | Longint | Graphics importer reference |
![]() |
targetBlob | BLOB | BLOB to receive the image |
![]() |
targetType | String4 | 4-char image type identifier |
![]() |
exportSettings | BLOB | Export settings |
![]() |
error | Longint | Error result |
Saves the image associated with a graphics importer instance into a BLOB, in the specified format.
The graphics importer instance is specified by importerRef. If importerRef does not refer to an existing graphics importer instance, the qpx_paramErr error code is returned.
The targetBlob parameter is the target BLOB. Uppon successful completion of the command, targetBlob receives the image data.
The targetType parameter specifies the target file format. 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 4.x.
qpx_JPEGFile | "JPEG" | JPEG/JIFF file format |
qpx_TIFFFile | "TIFF" | TIFF file format |
qpx_PNGFile | "PNGf" | PNG file format |
qpx_BMPFile | "BMPf" | BMP file format |
qpx_PhotoshopFile | "8BPS" | Adobe Photoshop file format |
qpx_PictureFile | "PICT" | Apple PICT file format |
qpx_QTImageFile | "qtif" | QuickTime Image file format |
qpx_TargaFile | "TPIC" | Truevision Targa file format |
qpx_SGIImageFile | ".SGI" | Silicon Graphics SGI file format |
qpx_MacPaintFile | "PNTG" | Apple MacPaint file format |
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 private to QuickTime and cannot be constructed or altered with 4D BLOB commands. To let the user modify the export settings, call the QPx_DoExportSettingsDialog command.
Related commands
QPx_GetExportTypes | Returns the list of available export types |
QPx_DoExportSettingsDialog | Displays the export settings dialog for a specific file type |