Legacy Document

Inside Macintosh: Imaging With QuickDraw /

Chapter 7 - Pictures / Pictures Reference

QuickDraw and Picture Utilities Routines / Collecting Picture Information

RecordPixMapInfo

To add a pixel map or bitmap to an informational survey of multiple pixel maps and bitmaps, use the RecordPictInfo function.

FUNCTION RecordPixMapInfo (thePictInfoID: PictInfoID; 
                          thePixMapHandle: PixMapHandle): OSErr;

thePictInfoID

The ID number--returned by the NewPictInfo function--that identifies the survey to which you are adding the pixel map or bitmap. The NewPictInfo function is described on page 7-52.

thePixMapHandle

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

DESCRIPTION

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, described on page 7-57, to return information about all the images in the survey.

SPECIAL CONSIDERATIONS

The RecordPixMapInfo function may move or purge memory.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for the RecordPixMapInfo function are

Trap macro	Selector
_Pack15	$0404

RESULT CODES

pictInfoIDErr	-11001	Invalid picture information ID
pictureDataErr	-11005	Invalid picture data