Important: The information in this document is obsolete and should not be used for new development.
RecordPictInfo
To add a picture to an informational survey of multiple pictures, use theRecordPictInfo
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. TheNewPictInfo
function is described on page 7-52.thePictHandle
A handle to the picture being added to the survey.DESCRIPTION
TheRecordPictInfo
function adds the picture you specify in the parameterthePictHandle
to the survey of pictures identified by the parameterthePictInfoID
. UseRecordPictInfo
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 opcodesRGBFgCol
,RGBBkCol
,BkPixPat
,PnPixPat
,FillPixPat
, andHiliteColor
. 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 theGetPixMapInfo
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 theRecordPictInfo
function are
Trap macro Selector _Pack15 $0403 RESULT CODES
pictInfoIDErr -11001 Invalid picture information ID pictureDataErr -11005 Invalid picture data