QPix Command Reference |
![]() ![]() |
QPix accomplishes most of its functionality with the help of QuickTime's graphics import components, aka "graphics importers".
When dealing with image files and plug-in areas QPix uses graphics importers internally and masks out all potentially confusing details. However, in order to provide the most of QuickTime's capabilities and flexibility, QPix also includes a set of commands for directly working with graphics importers.
Graphics importers are code modules. Each importer "knows" all the details of a specific graphic file format and provides specific services to the client software. Graphics importers have the following properties:
Type (String4) (In pure IM terms, this is the component subtype field)
Flags (Longint)
Name (String255)
The files supported by a graphics importer are specified by the importer's type in conjunction with bit #12 of the flags property. If bit #12 is off, the importer's type is the Mac file type of the supported files. If bit #12 is on, it is a filename extension.
Examples
Type: | '8BPS' |
Flags: | 0x40000000 |
Name: | Photoshop |
This is the Photoshop importer. It supports files of type '8BPS' (0x40000000 bit #12 is false).
Type: | 'GIF ' |
Flags: | 0x40001200 |
Name: | GIF |
This importer knows how to handle GIF files. It supports files with the .GIF filename extension (0x40001200 bit #12 is true).
Note
QPx_NewImporterForFile | Creates a graphics importer instance for the image stored in a file |
QPx_NewImporterForData | Creates a graphics importer instance for the image data stored in a BLOB |
QPx_NewImporter | Creates a graphics importer instance |
QPx_FreeImporter | Destroys an existing importer instance |
QPx_SetImporterFile | Assigns an image file to a graphics importer |
QPx_GetImporterFile | Returns the pathname of the file associated with a graphics importer |
QPx_SetImporterData | Assigns the image data contained in a BLOB to a graphics importer |
QPx_GetImporterData | Returns the image data associated with a graphics importer |
QPx_SetImporterOffsetAndLimit | Specifies start and end of data within a container |
QPx_GetImporterOffsetAndLimit | Returns start and end of data within a container |
QPx_ValidateImporter | Asks a graphic importer to test image data |
QPx_GetImporterImageSize | Returns the dimensions of the image associated with a graphics importer |
QPx_GetImporterImageRes | Returns the resolutions of the image associated with a graphics importer |
QPx_GetImporterImageDepth | Returns the pixel depth of the image associated with a graphics importer |
QPx_SetImporterQuality | Sets the drawing quality property of a graphics importer |
QPx_GetImporterQuality | Returns the drawing quality property of a graphics importer |
QPx_SetImporterGraphicsMode | Sets the transfer mode of a graphics importer |
QPx_GetImporterGraphicsMode | Returns the transfer mode currently used by a graphics importer |
QPx_GetImporterInfo | Returns information about a graphics importer |
QPx_ExportImporterImage | Exports a graphic importer |
QPx_ReadImporterImageInPict | Reads the image associated with a graphics importer |
QPx_GetImporterImageThumbnail | Creates a thumbnail from image data associated with a graphic importer |
QPx_SetAreaImporter | Assigns a graphics importer instance to a QPix plug-in area |
QPx_GetAreaImporter | Returns a reference to the graphic importer used by a QPix plug-in area |
QPx_NewImporterForURL | Creates a graphics importer from a URL |
QPx_CountImporterImages | Returns the number of images in a multi-image container |
QPx_SetImporterImageIndex | Changes the current image in a multi-image container |
QPx_GetImporterImageIndex | Returns the current image of a multi-image container |
QPx_GetImporterMetaData | Extracts metadata |
QPx_GetImporterMetaDataItem | Extracts individual metadata items as BLOBs |
QPx_ExportImporterImageToBLOB | Exports a graphic importer into a BLOB |