Carbon


FMOutput

Header: Fonts.h

struct FMOutput {
    SInt16 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 FMOutput FMOutputPtr;

Field descriptions

errNum

Reserved for use by Apple Computer, Inc.

fontHandle

A handle to the font resource requested by the font input structure, which may either be a bitmapped font or outline font resource. The bitmapped font is described in the section ‘NFNT'. The outline font is described in the section 'sfnt'.

boldPixels

Modifies how QuickDraw applies the bold style on the screen and on raster printers. Other display devices may handle styles differently.

italicPixels

Modifies how QuickDraw applies the italic style on the screen and on raster printers. Other display devices may handle styles differently.

ulOffset

Modifies how QuickDraw applies the underline style on the screen and on raster printers. Other display devices may handle styles differently.

ulShadow

Modifies how QuickDraw applies the underline shadow style on the screen and on raster printers. Other display devices may handle styles differently.

ulThick

Modifies how QuickDraw applies the thickness of the underline style on the screen and on raster printers. Other display devices may handle styles differently.

shadowPixels

Modifies how QuickDraw applies the shadow style on the screen and on raster printers. Other display devices may handle styles differently.

extra

The number of pixels by which the styles have widened each glyph.

ascent

The ascent measurement of the font. Any algorithmic styles or stretching that may be applied to the font are not taken into account for this value.

descent

The descent measurement of the font. Any algorithmic styles or stretching that may be applied to the font are not taken into account for this value.

widMax

The maximum width of the font. Any algorithmic styles or stretching that may be applied to the font are not taken into account for this value.

leading

The leading assigned to the font. Any algorithmic styles or stretching that may be applied to the font are not taken into account for this value.

curStyle

The actual style being made available for QuickDraw’s text drawing, as opposed to the requested style.

numer

The numerators of the vertical and horizontal scaling factors. The numer field is of type Point and contains two integers: the first is the numerator of the ratio for vertical scaling and the second is the numerator of the ratio for horizontal scaling.

denom

The denominators of the vertical and horizontal scaling factors. The denom field is of type Point and contains two integers: the first is the denominator of the ratio for vertical scaling and the second is the denominator of the ratio for horizontal scaling.

The font output structure, of data type FMOutput, contains a handle to a font and information about font measurements. It is filled in by the Font Manager upon responding to a font request. You can request a font using the FMSwapFont function.

The bold, italic, ulOffset, ulShadow, ulThick, and shadow values are all used to communicate to QuickDraw how to modify the way it renders each stylistic variation. Each byte value is taken from the font characterization table of the printer driver and is used by QuickDraw when it draws to a screen or raster printer.

The ascent, descent, widMax, and leading values can all be different in this structure than the corresponding values in the FontInfo structure that is produced by the GetFontInfo function in QuickDraw. This is because GetFontInfo takes into account any algorithmic styles or stretching that QuickDraw performs, while the Font Manager functions do not.

The numer and denom values are used to designate how font scaling is to be done. The values for these fields in the font output structure can be different than the values specified in the font input structure.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)