Carbon


RecordPixMapInfo

Header: PictUtils.h Carbon status: Supported

Adds a pixel map or bitmap to an informational survey of multiple pixel maps and bitmaps.

OSErr RecordPixMapInfo (
    PictInfoID thePictInfoID, 
    PixMapHandle thePixMapHandle
);
Parameter descriptions
thePictInfoID

The ID number—returned by the NewPictInfo function—that identifies the survey to which you are adding the pixel map or bitmap.

thePixMapHandle

A handle to a pixel map or bitmap to be added to the survey.

function result

A result code.

DISCUSSION

The RecordPixMapInfo function adds the pixel map or bitmap you specify in the parameter thePixMapHandle to the survey identified by the parameter thePictInfoID. Use RecordPictInfo repeatedly to add additional pixel maps and bitmaps to your survey.

After you have collected all of the images you need, use the RetrievePictInfo function to return information about all the images in the survey.

SPECIAL CONSIDERATIONS

The RecordPixMapInfo function may move or purge memory.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)