IFIMETRICS structure

The IFIMETRICS structure defines information for a given typeface that GDI can use.

Syntax


typedef struct _IFIMETRICS {
  ULONG   cjThis;
  ULONG   cjIfiExtra;
  PTRDIFF dpwszFamilyName;
  PTRDIFF dpwszStyleName;
  PTRDIFF dpwszFaceName;
  PTRDIFF dpwszUniqueName;
  PTRDIFF dpFontSim;
  LONG    lEmbedId;
  LONG    lItalicAngle;
  LONG    lCharBias;
  PTRDIFF dpCharSets;
  BYTE    jWinCharSet;
  BYTE    jWinPitchAndFamily;
  USHORT  usWinWeight;
  ULONG   flInfo;
  USHORT  fsSelection;
  USHORT  fsType;
  FWORD   fwdUnitsPerEm;
  FWORD   fwdLowestPPEm;
  FWORD   fwdWinAscender;
  FWORD   fwdWinDescender;
  FWORD   fwdMacAscender;
  FWORD   fwdMacDescender;
  FWORD   fwdMacLineGap;
  FWORD   fwdTypoAscender;
  FWORD   fwdTypoDescender;
  FWORD   fwdTypoLineGap;
  FWORD   fwdAveCharWidth;
  FWORD   fwdMaxCharInc;
  FWORD   fwdCapHeight;
  FWORD   fwdXHeight;
  FWORD   fwdSubscriptXSize;
  FWORD   fwdSubscriptYSize;
  FWORD   fwdSubscriptXOffset;
  FWORD   fwdSubscriptYOffset;
  FWORD   fwdSuperscriptXSize;
  FWORD   fwdSuperscriptYSize;
  FWORD   fwdSuperscriptXOffset;
  FWORD   fwdSuperscriptYOffset;
  FWORD   fwdUnderscoreSize;
  FWORD   fwdUnderscorePosition;
  FWORD   fwdStrikeoutSize;
  FWORD   fwdStrikeoutPosition;
  BYTE    chFirstChar;
  BYTE    chLastChar;
  BYTE    chDefaultChar;
  BYTE    chBreakChar;
  WCHAR   wcFirstChar;
  WCHAR   wcLastChar;
  WCHAR   wcDefaultChar;
  WCHAR   wcBreakChar;
  POINTL  ptlBaseline;
  POINTL  ptlAspect;
  POINTL  ptlCaret;
  RECTL   rclFontBox;
  BYTE    achVendId[4];
  ULONG   cKerningPairs;
  ULONG   ulPanoseCulture;
  PANOSE  panose;
#if defined(_WIN64)
  PVOID   Align;
#endif 
} IFIMETRICS, *PIFIMETRICS;

Members

cjThis

Specifies the size in bytes of this structure. The specified size includes any Unicode strings appended to the end of this structure, plus the size in bytes of the optional IFIEXTRA structure.

cjIfiExtra

Specifies the size in bytes of the IFIEXTRA structure that follows this IFIMETRICS structure. A value of zero indicates that no IFIEXTRA structure is present.

dpwszFamilyName

Specifies the offset in bytes to a null-terminated Unicode string containing the family name of the font (for example, "Times Roman"). Generally, this string immediately follows the IFIMETRICS structure. This string should be the same as the name recorded in the lfFaceName member of the Win32 LOGFONT structure.

dpwszStyleName

Specifies the offset in bytes to a null-terminated Unicode string describing the style of the font (for example, "Bold").

dpwszFaceName

Specifies the offset in bytes to a null-terminated Unicode string representing the unique and complete name of the font. The name contains the family and subfamily names of the font (for example, "Times New Roman Bold").

dpwszUniqueName

Specifies the offset in bytes to a null-terminated Unicode string representing the unique identifier of the font (for example, "Monotype:Times New Roman:1990").

dpFontSim

Specifies the offset in bytes from the beginning of this IFIMETRICS structure to a FONTSIM structure that describes the simulations that the font supports. The driver should set this member to a nonzero value only if the font supports bold, italic, or bold italic simulations; otherwise, the driver should set this to zero.

Note that if a font is italic by design, the driver should not indicate font support for italic simulation although it can indicate font support for bold italic simulation. Similarly, the driver should not indicate font support for bold simulation if the font is bold by design, but can indicate font support for bold italic simulation. If the font is both bold and italic by design, it should not support any simulations.

The offsets in the FONTSIM structure are relative to the base of the FONTSIM structure.

lEmbedId

Specifies the Embedding ID of the font. This value is TrueType-specific and should be set to zero by all other font providers.

lItalicAngle

Specifies the italic angle of the font. This value is TrueType-specific and should be set to zero by all other font providers.

lCharBias

Specifies the character bias. This value is TrueType-specific and should be set to zero by all other font providers.

dpCharSets

Specifies the offset from the beginning of this IFIMETRICS structure to an array containing a list of all Windows character sets supported by this font. The array is 16 bytes in size and is always terminated with DEFAULT_CHARSET. The first value of the array should identify the Windows character set that has the best and most complete coverage in the font; this value should also be stored in jWinCharSet. For instance, if this is a Japanese font that also supports US ANSI and Cyrillic character sets, then jWinCharSet should be set to SHIFTJIS_CHARSET and the array identified by dpCharSets would contain SHIFTJIS_CHARSET, ANSI_CHARSET, RUSSIAN_CHARSET, DEFAULT_CHARSET.

If this font does not support more than one Windows character set, dpCharSets should be set to zero.

jWinCharSet

Identifies the character set best supported by this font. If the font supports only a single Windows character set, the driver should store the corresponding value in jWinCharSet. The driver should not store DEFAULT_CHARSET in this field. This member can be one of the following values:

ValueMeaning

ANSI_CHARSET

This font supports the Windows ANSI character set.

ARABIC_CHARSET

This font supports the Arabic character set.

BALTIC_CHARSET

This font supports the Baltic character set.

CHINESEBIG5_CHARSET

This font supports the traditional Chinese (Big 5) character set.

EASTEUROPE_CHARSET

This font supports the Eastern European character set.

GB2312_CHARSET

This font supports the simplified (PRC) Chinese character set.

GREEK_CHARSET

This font supports the Greek character set.

HANGEUL_CHARSET

This font supports the Korean (Hangeul) character set.

HEBREW_CHARSET

This font supports the Hebrew character set.

JOHAB_CHARSET

This font supports the Korean (Johab) character set.

OEM_CHARSET

This font supports an OEM-specific character set. The OEM character set is system dependent.

SHIFTJIS_CHARSET

This font supports the Shift-JIS (Japanese Industry Standard) character set.

SYMBOL_CHARSET

This font supports the Windows symbol character set.

RUSSIAN_CHARSET

This font supports the Cyrillic character set.

THAI_CHARSET

This font supports the Thai character set.

TURKISH_CHARSET

This font supports the Turkish character set.

VIETNAMESE_CHARSET

This font supports the Vietnamese character set.

 

jWinPitchAndFamily

Specifies the pitch of the font. The two low-order bits specify the pitch of the font and can be one of the following values:

ValueMeaning

FIXED_PITCH

For fixed pitch fonts

VARIABLE_PITCH

For variable pitch fonts

 

Bits 4 through 7 of this member specify the font family and can be one of the following values:

ValueMeaning

FF_DECORATIVE

Novelty fonts, such as Old English.

FF_DONTCARE

Don't care or unknown.

FF_MODERN

Fonts with constant stroke width (fixed-pitch), with or without serifs. Fixed-pitch fonts are usually modern, such as Pica, Elite, and Courier.

FF_ROMAN

Fonts with variable stroke width (proportionally spaced) and with serifs, such as Times Roman, Palatino, and Century Schoolbook.

FF_SCRIPT

Fonts designed to look like handwriting, such as Script and Cursive.

FF_SWISS

Fonts with variable stroke width (proportionally spaced) and without serifs, such as Helvetica and Swiss.

 

usWinWeight

Specifies the weight of the font in the range 0 to 1000 (for example, 400 is normal and 700 is bold). This value is provided to the application in the lfWeight member of the Win32 LOGFONT structure.

flInfo

Specifies additional information about the font. This field can be a combination of the following flag values:

FM_INFO_1BPP

Indicates that a glyph bitmap has a color depth of one bit per pixel. For Windows NT 3.1, the first version of Windows NT, this flag must be set.

FM_INFO_4BPP

Indicates that a glyph bitmap has a color depth of four bits per pixel. The driver should set this if the font supports antialiased glyph bitmaps with 16 levels of gray.

FM_INFO_8BPP

Indicates that a glyph bitmap has a color depth of eight bits per pixel. The current version of GDI will ignore this setting as it does not support color fonts.

FM_INFO_16BPP

Indicates that a glyph bitmap has a color depth of 16 bits per pixel. The current version of GDI will ignore this setting as it does not support color fonts.

FM_INFO_24BPP

Indicates that a glyph bitmap has a color depth of 24 bits per pixel. The current version of GDI will ignore this setting as it does not support color fonts.

FM_INFO_32BPP

Indicates that a glyph bitmap has a color depth of 32 bits per pixel. The current version of GDI will ignore this setting as it does not support color fonts.

FM_INFO_90DEGREE_ROTATIONS

Indicates that the font can be realized in 90 degree rotations of the original notional shape. GDI requests the rotation of a font by including the rotation in the notional to device transformation passed to the driver when creating the font. This member has meaning only when the FM_INFO_ARB_XFORMS flag has not been set.

FM_INFO_ANISOTROPIC_SCALING_ONLY

Indicates that the font supports only arbitrary anisotropic scaling. That is, transforms are equivalent to a diagonal matrix multiplied by a positive real number. If this flag is set, then the FM_INFO_ARB_XFORMS and the FM_INFO_ISOTROPIC_SCALING_ONLY flags cannot be set. If the FM_INFO_90DEGREE_ROTATIONS flag is also set, the font supports transformations that are a combination of a simple anisotropic scaling followed by a rotation by a multiple of 90 degrees.

FM_INFO_ARB_XFORMS

Indicates that a font can be realized under a continuous range of two dimensional linear transformations.

FM_INFO_CONSTANT_WIDTH

Indicates that all glyphs of the font under all realizations have the same value of character increment. If this flag is set, the FM_INFO_OPTICALLY_FIXED_PITCH flag must also be set.

FM_INFO_DBCS_FIXED_PITCH

Indicates that double-byte characters for this font are fixed pitch. Nothing is implied about single byte characters. This flag is meaningful only for fonts that support a double-byte character set (DBCS), such as shift JIS. Fonts that do not support a DBCS should not set this flag.

FM_INFO_DO_NOT_ENUMERATE

Indicates that this font will not be enumerated by the Win32 EnumFontFamiliesEx, EnumFontFamilies or EnumFonts routines. Moreover, the string returned to a Win32 application call to GetTextFace will be retrieved from the string dpwszUniqueName. This flag allows the font provider to associate more than one IFIMETRICS structure with one of its fonts.

FM_INFO_DSIG

Indicates that a font is compliant with the Unicode standard.

FM_INFO_FAMILY_EQUIV

Indicates that the dpwszFamilyName offset in IFIMETRICS is actually the offset to a list of equivalent family names or aliases. The first name is the base or real name; the subsequent names are equivalents or aliases. Each name in the list is null-terminated; the list is terminated by two zeros.

<base name> <0> <alias 1> <0>...<alias n>
<0> <0>

The based names are used only for mapping; they are not enumerated.

FM_INFO_IGNORE_TC_RA_ABLE

Indicates that, for this font, the TC_RA_ABLE flag is ignored.

FM_INFO_INTEGER_WIDTH

Indicates that all glyphs have nonfractional advance widths. Bitmap fonts usually set this flag.

FM_INFO_INTEGRAL_SCALING

Indicates that the font can be scaled by an integral amount in both the x and y directions. If this flag is set, then the driver must be able to render glyphs in the case where the notional to device transformation is scaled by integral amounts in the x and y directions. GDI requests the integral scaling of a font by including the axial scalings in the notional to device transformation passed to the driver when creating the font. This flag is meaningful only when the FM_INFO_ARB_XFORMS flag has not been set.

FM_INFO_ISOTROPIC_SCALING_ONLY

Indicates that the font supports arbitrary isotropic scaling only. That is, transforms are equivalent to the identity matrix multiplied by a positive real number. If this flag is set, then neither the FM_INFO_ARB_XFORMS nor the FM_INFO_ANISOTROPIC_SCALING_ONLY flags can be set. If the FM_INFO_90DEGREE_ROTATIONS flag is set, the font supports transformations equivalent to an isotropic scaling followed by a rotation by a multiple of 90 degrees.

FM_INFO_OPTICALLY_FIXED_PITCH

Indicates that this font is considered typographically as fixed pitch. This is an optical quality of the font and does not necessarily indicate that all the glyphs of the font have the same character increment.

FM_INFO_NONNEGATIVE_AC

Indicates that all glyphs of this font have nonnegative a and c spacing. That is, the glyph black box never extends outside the region bordered by the character origin and the character concatenation point.

FM_INFO_NOT_CONTIGUOUS

Indicates that the supported character set is not contiguous.

FM_INFO_RETURNS_BITMAPS

Indicates that the font contains a valid digital signature.

FM_INFO_RETURNS_OUTLINES

Indicates that for any glyph supported by the driver, GDI can request a PATHOBJ structure that describes the outline of that glyph. If possible, when the outline is filled using GDI's path filling conventions, the resulting bitmap should be identical to the bitmap returned by the driver. The FM_INFO_RETURNS_OUTLINES and FM_INFO_RETURNS_STOKES flags cannot be set concurrently.

FM_INFO_RETURNS_STROKES

Indicates that for any glyph supported by the drivers, GDI can request a PATHOBJ structure that describes the spline of the glyph. This path cannot be filled but can be stroked to give a representation of the glyph. The FM_INFO_RETURNS_OUTLINES and FM_INFO_RETURNS_STOKES flags cannot be set concurrently.

FM_INFO_RIGHT_HANDED

Indicates that the ascent direction of the font is 90 degrees counterclockwise from the baseline direction. The ascent direction is the direction along which height is measured and is always perpendicular to the baseline direction.

FM_INFO_TECH_BITMAP

Indicates that the font is a bitmap font.

FM_INFO_TECH_CFF

Indicates that the font is a Pscript OpenType font that contains a Compact Font Format (CFF) table.

FM_INFO_TECH_MM

Indicates that this is a Multiple Master (MM) font.

FM_INFO_TECH_OUTLINE_NOT_TRUETYPE

Indicates that the font is based on a scalable font technology that uses outline paths, but is not based on TrueType. This flag does not specify whether the paths returned for this font should be filled or stroked; the consumer should examine the FM_INFO_RETURNS_STROKES and FM_INFO_RETURNS_OUTLINES flags for this information.

FM_INFO_TECH_STROKE

Indicates that the font is based on a stroked font technology. This flag does not specify whether the paths returned for this font should be filled or stroked; the consumer should examine the FM_INFO_RETURNS_STROKES and FM_INFO_RETURNS_OUTLINES flags for this information.

FM_INFO_TECH_TRUETYPE

Indicates that the font is a TrueType font.

FM_INFO_TECH_TYPE1

Indicates that this font is a PostScript screen font (either Type1 or OpenType PostScript).

fsSelection

Specifies a combination of the following flags:

ValueMeaning

FM_SEL_BOLD

Set if the characters of the font are bold.

FM_SEL_ITALIC

Set if the characters of the font are italic.

FM_SEL_NEGATIVE

Set if the characters of the font have the foreground and background reversed.

FM_SEL_OUTLINED

Set if the characters of the font are hollow.

FM_SEL_REGULAR

Set if the characters of the font are normal weight.

FM_SEL_STRIKEOUT

Set if the characters of the font are struck out by default; otherwise strikeouts must be simulated.

FM_SEL_UNDERSCORE

Set if all the characters of the font are underscored by default; otherwise underscoring must be simulated.

 

fsType

This is a TrueType-specific bitfield indicating certain properties for the font, such as font embedding and licensing rights for the font. Embeddable fonts can be stored in a document. When a document with embedded fonts is opened on a system that does not have the font installed (the remote system), the embedded font can be loaded for temporary (and in some cases permanent) use on that system by an embedding-aware application. Embedding licensing rights are granted by the font vendor. The following flags can be set:

ValueMeaning

FM_EDITABLE_EMBED

Set if the font can be embedded and temporarily loaded on other systems. Documents containing Editable fonts can be opened for reading and writing.

FM_READONLY_EMBED

Set if read/write embedding is not permitted; only "preview and print" encapsulation is allowed. When this bit is set, the font can be embedded and temporarily loaded on the remote system. Documents containing "preview and print" fonts must be opened "read-only;" no edits can be applied to the document.

FM_TYPE_LICENSED
FM_NO_EMBEDDING

Set if the font is a Restricted License font. When only this bit is set, this font must not be modified, embedded, or exchanged in any manner without first obtaining permission of the legal owner. For Restricted License embedding to take effect, it must be the only level of embedding selected.

 

Fonts with the FM_READONLY_EMBED bit set indicate that they can be embedded within documents but must only be installed temporarily on the remote system. Any document that includes an FM_READONLY_EMBED font must be opened "read-only." That is, the application can let the user view and/or print the document, but not edit it.

Fonts with the FM_EDITABLE_EMBED bit set indicate that they can be embedded in documents, but must only be installed temporarily on the remote system. In contrast to FM_READONLY_EMBED fonts, documents containing Editable fonts can be opened "read/write;" editing is permitted, and changes can be saved.

Fonts with no fsType bits set indicate that they can be embedded and permanently installed on the remote system by an application. The user of the remote system acquires the identical rights, obligations, and licenses for that font as the original purchaser of the font, and is subject to the same end-user license agreement, copyright, design patent, and/or trademark as was the original purchaser.

Applications that implement support for font embedding, either through use of the Font Embedding DLL or through other means, must not embed fonts that are not licensed to permit embedding. Further, applications loading embedded fonts for temporary use must delete the fonts when the document containing the embedded font is closed.

If multiple embedding bits are set, the least restrictive license granted takes precedence. For example, if bits 1 and 3 are set, bit 3 takes precedence over bit 1and the font can be embedded with Editable rights. For compatibility purposes, most vendors granting Editable embedding rights also set the Preview & Print bit (0x000C). This permits an application that only supports Preview & Print embedding to detect that font embedding is allowed.

fwdUnitsPerEm

Specifies the em-height of the font.

fwdLowestPPEm

Specifies the smallest readable size of the font, in pixels. This value is ignored for bitmap fonts.

fwdWinAscender

Specifies the Windows ascender value for the font.

fwdWinDescender

Specifies the Windows descender value for the font.

fwdMacAscender

Specifies the Macintosh ascender value for the font.

fwdMacDescender

Specifies the Macintosh descender value for the font. This number is typically less than zero. It measures the signed displacement from the base line of the lowest descender in the Macintosh character set.

fwdMacLineGap

Specifies the Macintosh line gap for the font. The suggested Macintosh interline spacing is equal to fwdMacLineGap + fwdMacAscenderfwdMacDescender.

fwdTypoAscender

Specifies the typographic ascender value for the font.

fwdTypoDescender

Specifies the typographic descender value for the font. This value specifies the signed displacement of the lowest descender from the baseline.

fwdTypoLineGap

Specifies the typographic line gap for the font.

fwdAveCharWidth

Specifies the arithmetic average of the width of all of the 26 lower case letters 'a' through 'z' of the Latin alphabet and the space character. If any of the 26 lowercase letters are not present, then this member should be set equal to the weighted average of all glyphs in the font.

fwdMaxCharInc

Specifies the maximum character increment of all glyphs in the font.

fwdCapHeight

Specifies the height of the optical line describing the top of the uppercase 'H' in font units (FUnits). This might not be the same as the measured height of the uppercase 'H.' If this information does not exist, fwdCapHeight should be set to zero, which indicates that it is undefined.

fwdXHeight

Specifies the height of the optical line describing the height of the lowercase 'x' in font units. This might not be the same as the measured height of the lowercase 'x.' A value of zero indicates that this member is undefined.

fwdSubscriptXSize

Specifies the suggested character width (the size along the baseline direction) of the subscript font.

fwdSubscriptYSize

Specifies the suggested character height (the size along the ascender direction) of the subscript font.

fwdSubscriptXOffset

Specifies the suggested offset in the baseline direction of the subscript character. The offset is with respect to the character origin of the base character.

fwdSubscriptYOffset

Specifies the suggested offset in the baseline direction of the subscript character. The offset is taken from the character origin of the base character.

fwdSuperscriptXSize

Specifies the suggested character width (the size along the baseline direction) of the superscript font.

fwdSuperscriptYSize

Specifies the suggested character height (the size along the ascender direction) of the superscript font.

fwdSuperscriptXOffset

Specifies the suggested offset in the baseline direction of the superscript character. The offset is taken from the character origin of the base character.

fwdSuperscriptYOffset

Specifies the suggested offset in the baseline direction of the superscript character. The offset is taken from the character origin of the base character.

fwdUnderscoreSize

Specifies the suggested width of the underscore bar, in font units.

fwdUnderscorePosition

Specifies the suggested displacement, in font units, from the base line to the middle of the underscore bar.

fwdStrikeoutSize

Specifies the suggested width of the strike-out bar, in font coordinates.

fwdStrikeoutPosition

Specifies the suggested displacement of the middle of the strikeout bar from the baseline.

chFirstChar

Specifies the lowest supported character in the code page specified in jWinCharSet. This field is provided for Windows 3.1 compatibility.

chLastChar

Specifies the highest supported character in the code page specified in jWinCharSet. This field is provided for Windows 3.1 compatibility.

chDefaultChar

Specifies the default character in the code page specified in jWinCharSet. This field is provided for Windows 3.1 compatibility.

chBreakChar

Specifies the break character in the code page specified in jWinCharSet. This field is provided for Windows 3.1 compatibility.

wcFirstChar

Specifies the supported character with the smallest Unicode character code.

wcLastChar

Specifies the supported character with the largest Unicode character code.

wcDefaultChar

Specifies the character to be substituted when an application requests a character that is not supported by the font.

wcBreakChar

Specifies the code point of the space character or its equivalent.

ptlBaseline

Specifies a POINTL structure that contains the intended writing direction of this font. For example, a typical Latin font specifies a value of (1,0).

ptlAspect

Specifies a POINTL structure that contains the aspect ratio of the pixel centers for which the bitmap font was designed. This value is used only by bitmap fonts.

ptlCaret

Specifies a POINTL structure that contains the direction of the ascender direction of the font. For example, the value for a nonitalicized Latin font is (0,1) while an italicized Latin font might specify a value of (2,5).

rclFontBox

Specifies a RECTL structure that describes the bounding box of all glyphs in the font in design space.

achVendId

Specifies a four character identifier for the font vendor. Identifiers are documented in the Microsoft TrueType specification.

cKerningPairs

Specifies the number of kerning pairs associated with this font.

ulPanoseCulture

Specifies the manner in which to interpret the panose number. This number should be set to FM_PANOSE_CULTURE_LATIN for Latin-based fonts. See the Microsoft Window SDK documentation for information about the PANOSE structure.

panose

Is an array of 10 bytes used to describe the visual characteristics of a given typeface. These characteristics are then used to associate the font with other fonts of similar appearance having different names. See the Window SDK documentation for information about the PANOSE structure.

Align

This member is defined only if the _WIN64 constant is defined. Its only purpose is to ensure that this structure is aligned correctly under the Itanium architecture.

Remarks

Additional information for a typeface can optionally be specified in the IFIEXTRA structure.

A driver's DrvQueryFont routine fills out and returns an IFIMETRICS structure to GDI.

The IFIMETRICS structure defines all the information for a typeface that GDI understands. Most of the members are FWORD values, which are signed 16-bit quantities in design space. If the font is a raster font, design space and device space are the same and a font unit is equivalent to the distance between pixels.

The coordinate system in the font/notional space is such that the y coordinate increases in an upward direction and the x coordinate increases to the right.

The IFIMETRICS structure's Align member causes it to be larger for x64 machines than for x32 machines, which has ramifications for binary font format files formatted according to this structure. Starting with Windows Server 2003 SP1, an additional, fixed-size structure has been added to Prntfont.h: PRINTIFI32. The PRINTIFI32 structure is identical to the IFIMETRICS structure, except that it does not contain an Align member.

Requirements

Header

Winddi.h (include Winddi.h)

See also

DrvQueryFont
IFIEXTRA
PATHOBJ

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft