The UMSPCDIPImageReader object is an Ultimedia Services Version 2 feature and does not apply to Ultimedia Services Version 1.2.1.
The UMSPCDIPImageReader object is derived from UMSImageReader base image reader class. This derived class offers functionality beyond that of the UMSImageReader, but it's methods are not shared among all derived image reader classes. Consequently, this class should be used only when there is a requirement for the extended functionality that it offers. If portability of code across different image formats is important, then applications should use only the UMSImageReader class.
To learn more about Photo CDs and the UMSPCDIPImageReader object, see:
For introductory information, see Formatted File Access Objects.
typedef struct umsdefPCDpacInfoRec {
unsigned short version;
unsigned short piwVersion;
unsigned short magnification;
unsigned long scanTime;
unsigned long modTime;
char mediaId;
char mediaType[20];
char scannerVendor[20];
char scannerProdID[60];
char scannerFirmRev[4];
char scannerFirmDate[8];
char scannerSerial[20];
char scannerSize[2];
char piwEquipment[20];
char nameCharSet;
char nameEscapes[32];
char photofinisher[60];
char SBAdata[106];
char copyright;
char copyrightFile[32];
} PCDpacInfoRec;
typedef struct umsdefPCDimageData {
octet *data;
UMSImageRect bounds;
unsigned short depth;
unsigned short stride;
} PCDimageData;
The Photo CD image Pac Image Reader methods include the following additional methods beyond those described in UMSImageReader Object .
The method converts a source point at the specified resolution to a corresponding point at PCD_ABSOLUTE resolution.
The method converts a rectangle at the specified resolution to a corresponding rectangle at PCD_ABSOLUTE resolution.
The method converts a point at PCD_ABSOLUTE resolution to a corresponding point at the specified resolution.
The method converts a rectangle at PCD_ABSOLUTE resolution to a corresponding rectangle at the specified resolution.
The method provides the factor by which a dimension at the specified resolution must be multiplied to get an equivalent dimension at PCD_ABSOLUTE resolution.
| in UMSImageSize *resolution | resolution specifies a resolution. |
| out short stepDif | stepDif returns the factor by which a dimension at the specified resolution must be multiplied. |
The caller supplies a pointer to a PCDpacInfo that read Image Pacs structure that it has allocated. The method copies scanning information related to a specific Image Pac into this structure. This information includes copyright information, scanner hardware and software data, scanning parameters, etc. Note: The strings in this structure are not NULL terminated.
| out PCDpacInfoRec info | info returns a pointer to a PCDpacInfoRec structure. |
The method specifies the path to the directory in which files that comprise the Image Pac Extensions are located. This is used only for reading Image Pac files that have been copied from a Photo CD disc to another medium.
| in string path | path specifies the path to the directory in which files that comprise the ImagePac Extensions are located. |
The method sets the maximum amount of memory used by the toolkit software for its private buffers during processing, in particular for dithering. Larger amounts of memory generally result in better performance. To force the toolkit to use the mimimum amount of memory, set maxBytes to 0. Callers should set the allowance if the format "RGB8PCDDither" is selected. Note that this value can also be changed by changing the PCDImagePac attribute CLASS_UMSImageReaderMem, described in UMSImageReaderMClass Usage .
| in long maxBytes | maxBytes specifies the maximum amount of memory to be used by the toolkit software. |
Get the actual amount of memory available to the toolkit for its private data buffers.
| out long maxBytes | maxBytes returns the actual amount of memory available to the toolkit for its data buffers. |
The method creates a new image pixmap by applying the specified transform (rotation and mirroring) to an existing pixmap. The method allocates outPixmap; the caller is responsible for deallocating outPixmap.
For introductory information, see Formatted File Access Objects.