/* File: PictUtils.h Contains: Picture Utilities Interfaces. Version: Technology: System 7.5 Release: QuickTime 4.0 Copyright: (c) 1990-1998 by Apple Computer, Inc., all rights reserved Bugs?: For bug reports, consult the following page on the World Wide Web: http://developer.apple.com/bugreporter/ */ #ifndef __PICTUTILS__ #define __PICTUTILS__ #ifndef __MACTYPES__ #include #endif #ifndef __PALETTES__ #include #endif #if PRAGMA_ONCE #pragma once #endif #ifdef __cplusplus extern "C" { #endif #if PRAGMA_IMPORT #pragma import on #endif #if PRAGMA_STRUCT_ALIGN #pragma options align=mac68k #elif PRAGMA_STRUCT_PACKPUSH #pragma pack(push, 2) #elif PRAGMA_STRUCT_PACK #pragma pack(2) #endif /* verbs for the GetPictInfo, GetPixMapInfo, and NewPictInfo calls */ enum { returnColorTable = 0x0001, returnPalette = 0x0002, recordComments = 0x0004, recordFontInfo = 0x0008, suppressBlackAndWhite = 0x0010 }; enum { /* color pick methods */ systemMethod = 0, /* system color pick method */ popularMethod = 1, /* method that chooses the most popular set of colors */ medianMethod = 2, /* method that chooses a good average mix of colors */ /* color bank types */ ColorBankIsCustom = -1, ColorBankIsExactAnd555 = 0, ColorBankIs555 = 1 }; typedef long PictInfoID; struct CommentSpec { short count; /* number of occurrances of this comment ID */ short ID; /* ID for the comment in the picture */ }; typedef struct CommentSpec CommentSpec; typedef CommentSpec * CommentSpecPtr; typedef CommentSpecPtr * CommentSpecHandle; struct FontSpec { short pictFontID; /* ID of the font in the picture */ short sysFontID; /* ID of the same font in the current system file */ long size[4]; /* bit array of all the sizes found (1..127) (bit 0 means > 127) */ short style; /* combined style of all occurrances of the font */ long nameOffset; /* offset into the fontNamesHdl handle for the font's name */ }; typedef struct FontSpec FontSpec; typedef FontSpec * FontSpecPtr; typedef FontSpecPtr * FontSpecHandle; struct PictInfo { short version; /* this is always zero, for now */ long uniqueColors; /* the number of actual colors in the picture(s)/pixmap(s) */ PaletteHandle thePalette; /* handle to the palette information */ CTabHandle theColorTable; /* handle to the color table */ Fixed hRes; /* maximum horizontal resolution for all the pixmaps */ Fixed vRes; /* maximum vertical resolution for all the pixmaps */ short depth; /* maximum depth for all the pixmaps (in the picture) */ Rect sourceRect; /* the picture frame rectangle (this contains the entire picture) */ long textCount; /* total number of text strings in the picture */ long lineCount; /* total number of lines in the picture */ long rectCount; /* total number of rectangles in the picture */ long rRectCount; /* total number of round rectangles in the picture */ long ovalCount; /* total number of ovals in the picture */ long arcCount; /* total number of arcs in the picture */ long polyCount; /* total number of polygons in the picture */ long regionCount; /* total number of regions in the picture */ long bitMapCount; /* total number of bitmaps in the picture */ long pixMapCount; /* total number of pixmaps in the picture */ long commentCount; /* total number of comments in the picture */ long uniqueComments; /* the number of unique comments in the picture */ CommentSpecHandle commentHandle; /* handle to all the comment information */ long uniqueFonts; /* the number of unique fonts in the picture */ FontSpecHandle fontHandle; /* handle to the FontSpec information */ Handle fontNamesHandle; /* handle to the font names */ long reserved1; long reserved2; }; typedef struct PictInfo PictInfo; typedef PictInfo * PictInfoPtr; typedef PictInfoPtr * PictInfoHandle; typedef CALLBACK_API( OSErr , InitPickMethodProcPtr )(SInt16 colorsRequested, UInt32 *dataRef, SInt16 *colorBankType); typedef STACK_UPP_TYPE(InitPickMethodProcPtr) InitPickMethodUPP; enum { uppInitPickMethodProcInfo = 0x00000FA0 }; /* pascal 2_bytes Func(2_bytes, 4_bytes, 4_bytes) */ #if MIXEDMODE_CALLS_ARE_FUNCTIONS EXTERN_API(InitPickMethodUPP) NewInitPickMethodProc (InitPickMethodProcPtr userRoutine); EXTERN_API(OSErr) CallInitPickMethodProc (InitPickMethodUPP userRoutine, SInt16 colorsRequested, UInt32 * dataRef, SInt16 * colorBankType); #else #define NewInitPickMethodProc(userRoutine) (InitPickMethodUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppInitPickMethodProcInfo, GetCurrentArchitecture()) #define CallInitPickMethodProc(userRoutine, colorsRequested, dataRef, colorBankType) CALL_THREE_PARAMETER_UPP((userRoutine), uppInitPickMethodProcInfo, (colorsRequested), (dataRef), (colorBankType)) #endif typedef CALLBACK_API( OSErr , RecordColorsProcPtr )(UInt32 dataRef, RGBColor *colorsArray, SInt32 colorCount, SInt32 *uniqueColors); typedef STACK_UPP_TYPE(RecordColorsProcPtr) RecordColorsUPP; enum { uppRecordColorsProcInfo = 0x00003FE0 }; /* pascal 2_bytes Func(4_bytes, 4_bytes, 4_bytes, 4_bytes) */ #if MIXEDMODE_CALLS_ARE_FUNCTIONS EXTERN_API(RecordColorsUPP) NewRecordColorsProc (RecordColorsProcPtr userRoutine); EXTERN_API(OSErr) CallRecordColorsProc (RecordColorsUPP userRoutine, UInt32 dataRef, RGBColor * colorsArray, SInt32 colorCount, SInt32 * uniqueColors); #else #define NewRecordColorsProc(userRoutine) (RecordColorsUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppRecordColorsProcInfo, GetCurrentArchitecture()) #define CallRecordColorsProc(userRoutine, dataRef, colorsArray, colorCount, uniqueColors) CALL_FOUR_PARAMETER_UPP((userRoutine), uppRecordColorsProcInfo, (dataRef), (colorsArray), (colorCount), (uniqueColors)) #endif typedef CALLBACK_API( OSErr , CalcColorTableProcPtr )(UInt32 dataRef, SInt16 colorsRequested, void *colorBankPtr, CSpecArray resultPtr); typedef STACK_UPP_TYPE(CalcColorTableProcPtr) CalcColorTableUPP; enum { uppCalcColorTableProcInfo = 0x00003EE0 }; /* pascal 2_bytes Func(4_bytes, 2_bytes, 4_bytes, 4_bytes) */ #if MIXEDMODE_CALLS_ARE_FUNCTIONS EXTERN_API(CalcColorTableUPP) NewCalcColorTableProc (CalcColorTableProcPtr userRoutine); EXTERN_API(OSErr) CallCalcColorTableProc (CalcColorTableUPP userRoutine, UInt32 dataRef, SInt16 colorsRequested, void * colorBankPtr, CSpecArray* resultPtr); #else #define NewCalcColorTableProc(userRoutine) (CalcColorTableUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppCalcColorTableProcInfo, GetCurrentArchitecture()) #define CallCalcColorTableProc(userRoutine, dataRef, colorsRequested, colorBankPtr, resultPtr) CALL_FOUR_PARAMETER_UPP((userRoutine), uppCalcColorTableProcInfo, (dataRef), (colorsRequested), (colorBankPtr), (resultPtr)) #endif typedef CALLBACK_API( OSErr , DisposeColorPickMethodProcPtr )(UInt32 dataRef); typedef STACK_UPP_TYPE(DisposeColorPickMethodProcPtr) DisposeColorPickMethodUPP; enum { uppDisposeColorPickMethodProcInfo = 0x000000E0 }; /* pascal 2_bytes Func(4_bytes) */ #if MIXEDMODE_CALLS_ARE_FUNCTIONS EXTERN_API(DisposeColorPickMethodUPP) NewDisposeColorPickMethodProc (DisposeColorPickMethodProcPtr userRoutine); EXTERN_API(OSErr) CallDisposeColorPickMethodProc (DisposeColorPickMethodUPP userRoutine, UInt32 dataRef); #else #define NewDisposeColorPickMethodProc(userRoutine) (DisposeColorPickMethodUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppDisposeColorPickMethodProcInfo, GetCurrentArchitecture()) #define CallDisposeColorPickMethodProc(userRoutine, dataRef) CALL_ONE_PARAMETER_UPP((userRoutine), uppDisposeColorPickMethodProcInfo, (dataRef)) #endif EXTERN_API( OSErr ) GetPictInfo (PicHandle thePictHandle, PictInfo * thePictInfo, short verb, short colorsRequested, short colorPickMethod, short version) THREEWORDINLINE(0x303C, 0x0800, 0xA831); EXTERN_API( OSErr ) GetPixMapInfo (PixMapHandle thePixMapHandle, PictInfo * thePictInfo, short verb, short colorsRequested, short colorPickMethod, short version) THREEWORDINLINE(0x303C, 0x0801, 0xA831); EXTERN_API( OSErr ) NewPictInfo (PictInfoID * thePictInfoID, short verb, short colorsRequested, short colorPickMethod, short version) THREEWORDINLINE(0x303C, 0x0602, 0xA831); EXTERN_API( OSErr ) RecordPictInfo (PictInfoID thePictInfoID, PicHandle thePictHandle) THREEWORDINLINE(0x303C, 0x0403, 0xA831); EXTERN_API( OSErr ) RecordPixMapInfo (PictInfoID thePictInfoID, PixMapHandle thePixMapHandle) THREEWORDINLINE(0x303C, 0x0404, 0xA831); EXTERN_API( OSErr ) RetrievePictInfo (PictInfoID thePictInfoID, PictInfo * thePictInfo, short colorsRequested) THREEWORDINLINE(0x303C, 0x0505, 0xA831); EXTERN_API( OSErr ) DisposePictInfo (PictInfoID thePictInfoID) THREEWORDINLINE(0x303C, 0x0206, 0xA831); #if OLDROUTINENAMES #define DisposPictInfo(thePictInfoID) DisposePictInfo(thePictInfoID) #endif /* OLDROUTINENAMES */ #if PRAGMA_STRUCT_ALIGN #pragma options align=reset #elif PRAGMA_STRUCT_PACKPUSH #pragma pack(pop) #elif PRAGMA_STRUCT_PACK #pragma pack() #endif #ifdef PRAGMA_IMPORT_OFF #pragma import off #elif PRAGMA_IMPORT #pragma import reset #endif #ifdef __cplusplus } #endif #endif /* __PICTUTILS__ */