QPx_NewImporterForData
QPx_NewImporterForData(importerRef; importerRef; importerRef):error | |||
---|---|---|---|
![]() |
importerRef | Longint | Reference to a new graphics importer |
![]() |
imageData | BLOB | 4D BLOB containing image data |
![]() |
importerType | Text | Importer type |
![]() |
error | Longint | Error result |
Create a graphics importer instance for the image data stored in a BLOB
Unlike QPx_NewImporterForFile, this command creates an importer for image data stored in the 4D BLOB specified in imageData. In this case, QPix and QuickTime have no way for identifying the image type. Therefore, you must explicitly specify a type by passing its 4-character type identifier in the importerType parameter. For a list of available graphics importers, use QPx_GetImportTypes.
A reference to the importer is returned in importerRef. This reference can be used with all QPix commands in this group to refer to the graphics importer instance and its associated data.
NOTE When done working with an importer instance, you must destroy it by calling QPx_FreeImporter (unless you have assigned the importer to a QPix area, in which case its destruction will be handled by the area).
Example
// Create an importer for image data strored in a BLOB C_LONGINT($error) C_TEXT($imagePath) C_BLOB($imageData) C_LONGINT(gQPixImporter) $imagePath:="Hard disk:images:people.gif" DOCUMENT TO BLOB($imagePath;$imageData) $error:=QPx_NewImporterForData (gQPixImporter;$imageData;qpx_GIFFile) If ($error=qpx_noErr) //Importer created successfully End if
Related commands
QPx_GetImportTypes | Get the list of available importers |
QPx_SetImporterData | Assign image data from a BLOB to a graphics importer |
QPx_GetImporterData | Get the image data associated with a graphics importer |