Important: The information in this document is obsolete and should not be used for new development.
RecordPictInfoTo add a picture to an informational survey of multiple pictures, use the
FUNCTION RecordPictInfo (thePictInfoID: PictInfoID; thePictHandle: PicHandle): OSErr;
- The ID number--returned by the
NewPictInfofunction--that identifies the survey to which you are adding the picture. The
NewPictInfofunction is described on page 7-52.
A handle to the picture being added to the survey.
RecordPictInfofunction adds the picture you specify in the parameter
thePictHandleto the survey of pictures identified by the parameter
RecordPictInforepeatedly to add additional pictures to your survey.
After you have collected all of the pictures you need, use the
RetrievePictInfofunction, described on page 7-57, to return information about pictures in the survey.
SPECIAL CONSIDERATIONSWhen you ask for color information,
RecordPictInfotakes into account only the version 2 and extended version picture opcodes
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
GetPixMapInfofunction (described on page 7-49) to obtain color information about that pixel map.
RecordPictInfofunction may move or purge memory.
ASSEMBLY-LANGUAGE INFORMATIONThe trap macro and routine selector for the
Trap macro Selector _Pack15 $0403
pictInfoIDErr -11001 Invalid picture information ID pictureDataErr -11005 Invalid picture data