NewPictInfo

Initialize a survey of a picture

OSErr NewPictInfo (thePictInfoID, verb, colorsRequested,

colorPickMethod, version);

PictInfoID  *thePictInfoID; a unique  value.
 short  verb;  selects what information (palettes or  color

tables, comments or fonts) is to be returned

short colorsRequested; the number of colors you want

short colorPickMethod; indicates the color-sampling method.

short version; Set the version parameter to 0.

returns Error Code; 0=no error

The NewPictInfo function initializes the survey by creating the identifier,

called the picture information ID, which associates a series of requests and

allocates data structures to contain the gathered information.

thePictInfoID receives a unique value.

verb selects what information (palettes or color tables, comments or

fonts) is to be returned by subsequent calls to RetrievePictInfo.

For surveying pixel map records, valid choices are returnPalette,

returnColorTable, and suppressBlackAndWhite, which are explained

in the description of GetPixMapInfo

For pictures, you can also use the verb parameter to request the

collection of comment and font information by specifying

recordComments and recordFontInfo.

colorsRequested specifies the number of colors you want returned in the palette or

color table; it may be from 1 to 256.

colorPickMethod indicates the color-sampling method. Its value can be systemMethod,

popularMethod, medianMethod, or the resource ID of your own

method.

version Set the version parameter to 0.

Returns: an operating system Error Code.

noErr (0) No error

pictInfoVersionErr (-11000) Version number not 0

pictInfoVerbErr (-11002) Invalid verb combination specified

cantLoadPickMethodErr (-11003) Custom pick method not in resource chain

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

Notes: NewPictInfo can potentially move and purge memory.

Referenced by (18):