RetrievePictInfo

Return picture and pixel map information

#include <PictUtil.h> Picture Utilities

OSErr RetrievePictInfo (thePictInfoID, thePictInfo,

colorsRequested);

PictInfoID thePictInfoID; specifies a picture information record

PictInfo *thePictInfo; a pointer to the picture information record

short colorsRequested; number of colors you want

returns Error Code; 0=no error

The RetrievePictInfo function returns the information requested by the

verb parameter passed to the associated NewPictInfo function specified by

thePictInfoID. You supply a pointer to the picture information record in

thePictInfo. If you requested a palette or color table, specify the number of

colors you want in the colorsRequested parameter.

You can call this function repeatedly, gathering new information after

additional calls to RecordPixMapInfo or RecordPictInfo. Remember to

dispose of the handles returned to you (thePalette, theColorTable,

commentHandle, fontHandle, and fontNamesHandle) when you finish with
them.

thePictInfoID picture information record specifier returned by NewPictInfo.

thePictInfo a pointer to a picture information record.

colorsRequested specifies the number of colors you want

Returns: an operating system Error Code.

noErr (0) No error

pictInfoIDErr (-11001) Invalid picture information ID

colorsRequestedErr (-11004) Number out of range or greater than passed to

Notes: RetrievePictInfo can potentially move and purge memory.

Referenced by (9):