Fonts.h

Go to the documentation of this file.

 
#ifndef __FONTS__
#define __FONTS__
 
#ifndef __MACTYPES__
#include <MacTypes.h>
#endif
 
#ifndef __ATSTYPES__
#include <ATSTypes.h>
#endif
 
#ifndef __FILES__
#include <Files.h>
#endif
 
#ifndef __MACERRORS__
#include <MacErrors.h>
#endif
 
#ifndef __QUICKDRAW__
#include <Quickdraw.h>
#endif
 
#ifndef __TEXTCOMMON__
#include <TextCommon.h>
#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
 
  enum
  {
    systemFont = 0,
    applFont = 1
  };
 
  enum
  {
    kFMDefaultOptions = kNilOptions
  };
 
  enum
  {
    kFMDefaultActivationContext = kFMDefaultOptions,
    kFMGlobalActivationContext = 0x00000001,
    kFMLocalActivationContext = kFMDefaultActivationContext
  };
 
  enum
  {
    kFMDefaultIterationScope = kFMDefaultOptions,
    kFMGlobalIterationScope = 0x00000001,
    kFMLocalIterationScope = kFMDefaultIterationScope
  };
 
#if TARGET_OS_MAC
  enum
  {
    kPlatformDefaultGuiFontID = applFont
  };
 
#else
enum
{
  kPlatformDefaultGuiFontID = -1
};
 
#endif 
  enum
  {
    commandMark = 17,
    checkMark = 18,
    diamondMark = 19,
    appleMark = 20
  };
 
  enum
  {
    propFont = 36864L,
    prpFntH = 36865L,
    prpFntW = 36866L,
    prpFntHW = 36867L,
    fixedFont = 45056L,
    fxdFntH = 45057L,
    fxdFntW = 45058L,
    fxdFntHW = 45059L,
    fontWid = 44208L
  };
 
  struct FMInput
  {
    short family;
    short size;
    Style face;
    Boolean needBits;
    short device;
    Point numer;
    Point denom;
  };
  typedef struct FMInput FMInput;
  struct FMOutput
  {
    short errNum;
    Handle fontHandle;
    UInt8 boldPixels;
    UInt8 italicPixels;
    UInt8 ulOffset;
    UInt8 ulShadow;
    UInt8 ulThick;
    UInt8 shadowPixels;
    SInt8 extra;
    UInt8 ascent;
    UInt8 descent;
    UInt8 widMax;
    SInt8 leading;
    SInt8 curStyle;
    Point numer;
    Point denom;
  };
  typedef struct FMOutput FMOutput;
  typedef FMOutput *FMOutputPtr;
  typedef FMOutputPtr FMOutPtr;
  struct FMetricRec
  {
    Fixed ascent;      
    Fixed descent;     
    Fixed leading;     
    Fixed widMax;      
    Handle wTabHandle; 
  };
  typedef struct FMetricRec FMetricRec;
  typedef FMetricRec *FMetricRecPtr;
  typedef FMetricRecPtr *FMetricRecHandle;
#if CALL_NOT_IN_CARBON
  void
  InitFonts(void);
 
#endif 
  void
  GetFontName(short familyID, Str255 name);
 
  void
  GetFNum(ConstStr255Param name, short *familyID);
 
  Boolean
  RealFont(short fontNum, short size);
 
#if CALL_NOT_IN_CARBON
  void
  SetFontLock(Boolean lockFlag);
 
#endif 
  FMOutPtr
  FMSwapFont(const FMInput *inRec);
 
  void
  SetFScaleDisable(Boolean fscaleDisable);
 
  void
  FontMetrics(FMetricRecPtr theMetrics);
 
  void
  SetFractEnable(Boolean fractEnable);
 
  short
  GetDefFontSize(void);
 
  Boolean
  IsOutline(Point numer, Point denom);
 
  void
  SetOutlinePreferred(Boolean outlinePreferred);
 
  Boolean
  GetOutlinePreferred(void);
 
  OSErr
  OutlineMetrics(short byteCount, const void *textPtr, Point numer, Point denom,
                 short *yMax, short *yMin, FixedPtr awArray, FixedPtr lsbArray,
                 RectPtr boundsArray);
 
  void
  SetPreserveGlyph(Boolean preserveGlyph);
 
  Boolean
  GetPreserveGlyph(void);
 
#if CALL_NOT_IN_CARBON
  OSErr
  FlushFonts(void);
 
#endif 
#if CALL_NOT_IN_CARBON
  void
  getfnum(const char *theName, short *familyID);
 
  void
  getfontname(short familyID, char *theName);
 
#endif 
  short
  GetSysFont(void);
 
  short
  GetAppFont(void);
 
  OSStatus
  SetAntiAliasedTextEnabled(Boolean iEnable, SInt16 iMinFontSize);
 
  Boolean
  IsAntiAliasedTextEnabled(SInt16 *oMinFontSize);
 
  void
  QDTextBounds(short byteCount, const void *textAddr, Rect *bounds);
 
  OSErr
  FetchFontInfo(SInt16 fontID, SInt16 fontSize, SInt16 fontStyle, FontInfo *info);
 
  OSStatus
  FMCreateFontFamilyIterator(const FMFilter *iFilter, 
                             void *iRefCon, OptionBits iOptions,
                             FMFontFamilyIterator *ioIterator);
 
  OSStatus
  FMDisposeFontFamilyIterator(FMFontFamilyIterator *ioIterator);
 
  OSStatus
  FMResetFontFamilyIterator(const FMFilter *iFilter, 
                            void *iRefCon, OptionBits iOptions,
                            FMFontFamilyIterator *ioIterator);
 
  OSStatus
  FMGetNextFontFamily(FMFontFamilyIterator *ioIterator,
                      FMFontFamily *oFontFamily);
 
  OSStatus
  FMCreateFontIterator(const FMFilter *iFilter, 
                       void *iRefCon, OptionBits iOptions,
                       FMFontIterator *ioIterator);
 
  OSStatus
  FMDisposeFontIterator(FMFontIterator *ioIterator);
 
  OSStatus
  FMResetFontIterator(const FMFilter *iFilter, 
                      void *iRefCon, OptionBits iOptions,
                      FMFontIterator *ioIterator);
 
  OSStatus
  FMGetNextFont(FMFontIterator *ioIterator, FMFont *oFont);
 
  OSStatus
  FMCreateFontFamilyInstanceIterator(FMFontFamily iFontFamily,
                                     FMFontFamilyInstanceIterator *ioIterator);
 
  OSStatus
  FMDisposeFontFamilyInstanceIterator(FMFontFamilyInstanceIterator *ioIterator);
 
  OSStatus
  FMResetFontFamilyInstanceIterator(FMFontFamily iFontFamily,
                                    FMFontFamilyInstanceIterator *ioIterator);
 
  OSStatus
  FMGetNextFontFamilyInstance(FMFontFamilyInstanceIterator *ioIterator,
                              FMFont *oFont,
                              FMFontStyle *oStyle, 
                              FMFontSize *oSize);  
  FMFontFamily
  FMGetFontFamilyFromName(ConstStr255Param iName);
 
  OSStatus
  FMGetFontFamilyName(FMFontFamily iFontFamily, Str255 oName);
 
  OSStatus
  FMGetFontFamilyTextEncoding(FMFontFamily iFontFamily,
                              TextEncoding *oTextEncoding);
 
  OSStatus
  FMGetFontFamilyGeneration(FMFontFamily iFontFamily, FMGeneration *oGeneration);
 
  OSStatus
  FMGetFontFormat(FMFont iFont, FourCharCode *oFormat);
 
  OSStatus
  FMGetFontTableDirectory(FMFont iFont, ByteCount iLength, void *iBuffer,
                          ByteCount *oActualLength); 
  OSStatus
  FMGetFontTable(FMFont iFont, FourCharCode iTag, ByteOffset iOffset,
                 ByteCount iLength, void *iBuffer,
                 ByteCount *oActualLength); 
  OSStatus
  FMGetFontGeneration(FMFont iFont, FMGeneration *oGeneration);
 
  OSStatus
  FMGetFontContainer(FMFont iFont, FSSpec *oFontContainer);
 
  OSStatus
  FMGetFontFromFontFamilyInstance(
      FMFontFamily iFontFamily, FMFontStyle iStyle, FMFont *oFont,
      FMFontStyle *oIntrinsicStyle); 
  OSStatus
  FMGetFontFamilyInstanceFromFont(FMFont iFont, FMFontFamily *oFontFamily,
                                  FMFontStyle *oStyle);
 
  ATSFontRef
  FMGetATSFontRefFromFont(FMFont iFont);
 
  ATSFontFamilyRef
  FMGetATSFontFamilyRefFromFontFamily(FMFontFamily iFamily);
 
  FMFont
  FMGetFontFromATSFontRef(ATSFontRef iFont);
 
  FMFontFamily
  FMGetFontFamilyFromATSFontFamilyRef(ATSFontFamilyRef iFamily);
 
  OSStatus
  FMActivateFonts(const FSSpec *iFontContainer,
                  const FMFilter *iFilter, 
                  void *iRefCon, OptionBits iOptions);
 
  OSStatus
  FMDeactivateFonts(const FSSpec *iFontContainer,
                    const FMFilter *iFilter, 
                    void *iRefCon, OptionBits iOptions);
 
  FMGeneration
  FMGetGeneration(void);
 
  OSStatus
  FMGetFontContainerFromFontFamilyInstance(FMFontFamily iFontFamily,
                                           FMFontStyle iStyle,
                                           FMFontSize iFontSize,
                                           FSSpec *oFontContainer);
 
  OSStatus
  FMGetFontFamilyResource(FMFontFamily iFontFamily, FMFontStyle iFontStyle,
                          FMFontSize iFontSize, ByteCount iBufferSize,
                          void *ioBuffer, ByteCount *oSize); 
  typedef FMFontFamily FontFamilyID;
  typedef FMFontSize FontPointSize;
  enum
  {
    kFMUseGlobalScopeOption = 0x00000001
  };
 
  enum
  {
    kFontIDNewYork = 2,
    kFontIDGeneva = 3,
    kFontIDMonaco = 4,
    kFontIDVenice = 5,
    kFontIDLondon = 6,
    kFontIDAthens = 7,
    kFontIDSanFrancisco = 8,
    kFontIDToronto = 9,
    kFontIDCairo = 11,
    kFontIDLosAngeles = 12,
    kFontIDTimes = 20,
    kFontIDHelvetica = 21,
    kFontIDCourier = 22,
    kFontIDSymbol = 23,
    kFontIDMobile = 24
  };
 
  struct WidEntry
  {
    short widStyle; 
  };
  typedef struct WidEntry WidEntry;
  struct WidTable
  {
    short numWidths; 
  };
  typedef struct WidTable WidTable;
  struct AsscEntry
  {
    short fontSize;
    short fontStyle;
    short fontID; 
  };
  typedef struct AsscEntry AsscEntry;
  struct FontAssoc
  {
    short numAssoc; 
  };
  typedef struct FontAssoc FontAssoc;
  struct StyleTable
  {
    short fontClass;
    long offset;
    long reserved;
    char indexes[48];
  };
  typedef struct StyleTable StyleTable;
  struct NameTable
  {
    short stringCount;
    Str255 baseFontName;
  };
  typedef struct NameTable NameTable;
  struct KernPair
  {
    char kernFirst;  
    char kernSecond; 
    short kernWidth; 
  };
  typedef struct KernPair KernPair;
  struct KernEntry
  {
    short kernStyle;  
    short kernLength; 
  };
  typedef struct KernEntry KernEntry;
  struct KernTable
  {
    short numKerns; 
  };
  typedef struct KernTable KernTable;
  struct WidthTable
  {
    Fixed tabData[256]; 
    Handle tabFont;     
    long sExtra;        
    long style;         
    short fID;          
    short fSize;        
    short face;         
    short device;       
    Point inNumer;      
    Point inDenom;      
    short aFID;         
    Handle fHand;       
    Boolean usedFam;    
    UInt8 aFace;        
    short vOutput;      
    short hOutput;      
    short vFactor;      
    short hFactor;      
    short aSize;        
    short tabSize;      
  };
  typedef struct WidthTable WidthTable;
  typedef WidthTable *WidthTablePtr;
  typedef WidthTablePtr *WidthTableHdl;
  struct FamRec
  {
    short ffFlags;       
    short ffFamID;       
    short ffFirstChar;   
    short ffLastChar;    
    short ffAscent;      
    short ffDescent;     
    short ffLeading;     
    short ffWidMax;      
    long ffWTabOff;      
    long ffKernOff;      
    long ffStylOff;      
    short ffProperty[9]; 
    short ffIntl[2];     
    short ffVersion;     
  };
  typedef struct FamRec FamRec;
  struct FontRec
  {
    short fontType;        
    short firstChar;       
    short lastChar;        
    short widMax;          
    short kernMax;         
    short nDescent;        
    short fRectWidth;      
    short fRectHeight;     
    unsigned short owTLoc; 
    short ascent;          
    short descent;         
    short leading;         
    short rowWords;        
  };
  typedef struct FontRec FontRec;
  typedef FontRec *FontRecPtr;
  typedef FontRecPtr *FontRecHdl;
#if OLDROUTINENAMES
  enum
  {
    newYork = kFontIDNewYork,
    geneva = kFontIDGeneva,
    monaco = kFontIDMonaco,
    venice = kFontIDVenice,
    london = kFontIDLondon,
    athens = kFontIDAthens,
    sanFran = kFontIDSanFrancisco,
    toronto = kFontIDToronto,
    cairo = kFontIDCairo,
    losAngeles = kFontIDLosAngeles,
    times = kFontIDTimes,
    helvetica = kFontIDHelvetica,
    courier = kFontIDCourier,
    symbol = kFontIDSymbol,
    mobile = kFontIDMobile
  };
 
#endif 
#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 
* / don,
    athens = kFontIDAthens,
    sanFran = kFontIDSanFrancisco,
    toronto = kFontIDToronto,
    cairo = kFontIDCairo,
    losAngeles = kFontIDLosAngeles,
    times = kFontIDTimes,
    helvetica = kFontIDHelvetica,
    courier = kFontIDCourier,
    symbol = kFontIDSymbol,
    mobile = kFontIDMobile
}
;
 
#endif 
#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 
* /*/*/ * /*/*/ * /