Legacy Document

Inside Macintosh: Imaging With QuickDraw /

Chapter 7 - Pictures / Pictures Reference

QuickDraw and Picture Utilities Routines / Collecting Picture Information

RecordPictInfo

To add a picture to an informational survey of multiple pictures, use the RecordPictInfo function.

FUNCTION RecordPictInfo (thePictInfoID: PictInfoID; 
                        thePictHandle: PicHandle): OSErr;

thePictInfoID

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

thePictHandle

A handle to the picture being added to the survey.

DESCRIPTION

The RecordPictInfo function adds the picture you specify in the parameter thePictHandle to the survey of pictures identified by the parameter thePictInfoID. Use RecordPictInfo repeatedly to add additional pictures to your survey.

After you have collected all of the pictures you need, use the RetrievePictInfo function, described on page 7-57, to return information about pictures in the survey.

SPECIAL CONSIDERATIONS

When you ask for color information, RecordPictInfo takes into account only the version 2 and extended version picture opcodes RGBFgCol, RGBBkCol, BkPixPat, PnPixPat, FillPixPat, and HiliteColor. Each occurrence of these opcodes is treated as 1 pixel, regardless of the number and sizes of the objects drawn with that color. If you need an accurate set of colors from a complex picture, create an image of the picture in an offscreen pixel map, and then call the GetPixMapInfo function (described on page 7-49) to obtain color information about that pixel map.

The RecordPictInfo function may move or purge memory.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for the RecordPictInfo function are

Trap macro	Selector
_Pack15	$0403

RESULT CODES

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