Inside Macintosh: QuickTime /

Chapter 3 - Image Compression Manager / Image Compression Manager Reference

Image Compression Manager Functions / Working With the StdPix Function

SetCompressedPixMapInfo

The SetCompressedPixMapInfo function allows your application to store information about a compressed image for the StdPix function (described in the previous section).

pascal OSErr SetCompressedPixMapInfo (PixMapPtr pix,
                           ImageDescriptionHandle desc, 
                           Ptr data, long bufferSize,
                           DataProcRecordPtr dataProc,
                           ProgressProcRecordPtr progressProc);

pix

Points to a structure that holds encoded compressed image data.

desc

Contains a handle to the image description structure that defines the compressed image.

data

Points to the buffer for the compressed image data. If the entire compressed image cannot be stored at this location, you may assign a data-loading function (see the discussion of the dataProc parameter to this function). This pointer must contain a 32-bit clean address.

bufferSize

Specifies the size of the buffer to be used by the data-loading
function specified by the dataProc parameter. If there is no
data-loading function defined for this operation, set this parameter to 0.

dataProc

Points to a data-loading function structure. If there is not enough memory to store the compressed image, the decompressor calls a function you provide that loads more compressed data (see "Data-Loading Functions" beginning on page 3-143 for more information about data-loading functions). If you do not want to assign a data-loading function, set this parameter to nil.

progressProc

Points to a progress function structure. During the decompression operation, the decompressor may occasionally call a function you provide in order to report its progress (see "Progress Functions" beginning on page 3-146 for more information about progress functions). If you do not want to assign a progress function, set this parameter to nil. If you pass a value of -1, you obtain a standard progress function.

DESCRIPTION

The SetCompressedPixMapInfo function stores information in a structure that is identical to a PixMap structure, but the structure represents the compressed data, not the actual pixel map. You can use the SetCompressedPixMapInfo if you are working with the StdPix function (described on page 3-132).

RESULT CODES

paramErr

-50

Invalid parameter specified

SEE ALSO

You can retrieve information about a compressed pixel map by calling the GetCompressedPixMapInfo function, which is described in the next section.