DWRITE_PANOSE union (dwrite_1.h)

The DWRITE_PANOSE union describes typeface classification values that you use with IDWriteFont1::GetPanose to select and match the font.

Syntax

union DWRITE_PANOSE {
  UINT8  values[10];
  UINT8  familyKind;
  struct {
    UINT8 familyKind;
    UINT8 serifStyle;
    UINT8 weight;
    UINT8 proportion;
    UINT8 contrast;
    UINT8 strokeVariation;
    UINT8 armStyle;
    UINT8 letterform;
    UINT8 midline;
    UINT8 xHeight;
  } text;
  struct {
    UINT8 familyKind;
    UINT8 toolKind;
    UINT8 weight;
    UINT8 spacing;
    UINT8 aspectRatio;
    UINT8 contrast;
    UINT8 scriptTopology;
    UINT8 scriptForm;
    UINT8 finials;
    UINT8 xAscent;
  } script;
  struct {
    UINT8 familyKind;
    UINT8 decorativeClass;
    UINT8 weight;
    UINT8 aspect;
    UINT8 contrast;
    UINT8 serifVariant;
    UINT8 fill;
    UINT8 lining;
    UINT8 decorativeTopology;
    UINT8 characterRange;
  } decorative;
  struct {
    UINT8 familyKind;
    UINT8 symbolKind;
    UINT8 weight;
    UINT8 spacing;
    UINT8 aspectRatioAndContrast;
    UINT8 aspectRatio94;
    UINT8 aspectRatio119;
    UINT8 aspectRatio157;
    UINT8 aspectRatio163;
    UINT8 aspectRatio211;
  } symbol;
};

Members

values[10]

A 10-byte array of typeface classification values.

familyKind

A DWRITE_PANOSE_FAMILY-typed value that specifies the typeface classification values to get.

text

The text structure.

text.familyKind

The DWRITE_PANOSE_FAMILY_TEXT_DISPLAY value (2) that specifies text display typeface classification.

text.serifStyle

A DWRITE_PANOSE_SERIF_STYLE-typed value that specifies the serif style of text.

text.weight

A DWRITE_PANOSE_WEIGHT-typed value that specifies the weight of the text.

text.proportion

A DWRITE_PANOSE_PROPORTION-typed value that specifies the proportion for the text.

text.contrast

A DWRITE_PANOSE_CONTRAST-typed value that specifies the contrast for the text.

text.strokeVariation

A DWRITE_PANOSE_STROKE_VARIATION-typed value that specifies the stroke variation for the text.

text.armStyle

A DWRITE_PANOSE_ARM_STYLE-typed value that specifies the arm style of text.

text.letterform

A DWRITE_PANOSE_LETTERFORM-typed value that specifies the letter form for the text.

text.midline

A DWRITE_PANOSE_MIDLINE-typed value that specifies the midline for the text.

text.xHeight

A DWRITE_PANOSE_XHEIGHT-typed value that specifies the relative size of lowercase text.

script

The script structure.

script.familyKind

The DWRITE_PANOSE_FAMILY_SCRIPT value (3) that specifies script typeface classification.

script.toolKind

A DWRITE_PANOSE_TOOL_KIND-typed value that specifies the kind of tool for the script.

script.weight

A DWRITE_PANOSE_WEIGHT-typed value that specifies the weight of the script.

script.spacing

A DWRITE_PANOSE_SPACING-typed value that specifies the spacing of the script.

script.aspectRatio

A DWRITE_PANOSE_ASPECT_RATIO-typed value that specifies the aspect ratio of the script.

script.contrast

A DWRITE_PANOSE_CONTRAST-typed value that specifies the contrast for the script.

script.scriptTopology

A DWRITE_PANOSE_SCRIPT_TOPOLOGY-typed value that specifies the script topology.

script.scriptForm

A DWRITE_PANOSE_SCRIPT_FORM-typed value that specifies the script form.

script.finials

A DWRITE_PANOSE_FINIALS-typed value that specifies the script finials.

script.xAscent

A DWRITE_PANOSE_XASCENT-typed value that specifies the relative size of lowercase letters.

decorative

The decorative structure.

decorative.familyKind

The DWRITE_PANOSE_FAMILY_DECORATIVE value (4) that specifies decorative typeface classification.

decorative.decorativeClass

A DWRITE_PANOSE_DECORATIVE_CLASS-typed value that specifies the class of the decorative typeface.

decorative.weight

A DWRITE_PANOSE_WEIGHT-typed value that specifies the weight of the decorative typeface.

decorative.aspect

A DWRITE_PANOSE_ASPECT-typed value that specifies the aspect of the decorative typeface.

decorative.contrast

A DWRITE_PANOSE_CONTRAST-typed value that specifies the contrast for the decorative typeface.

decorative.serifVariant

The serif variant of the decorative typeface.

decorative.fill

A DWRITE_PANOSE_FILL-typed value that specifies the fill of the decorative typeface.

decorative.lining

A DWRITE_PANOSE_LINING-typed value that specifies the lining of the decorative typeface.

decorative.decorativeTopology

A DWRITE_PANOSE_DECORATIVE_TOPOLOGY-typed value that specifies the decorative topology.

decorative.characterRange

A DWRITE_PANOSE_CHARACTER_RANGES-typed value that specifies the character range of the decorative typeface.

symbol

The symbol structure.

symbol.familyKind

The DWRITE_PANOSE_FAMILY_SYMBOL value (5) that specifies symbol typeface classification.

symbol.symbolKind

A DWRITE_PANOSE_SYMBOL_KIND-typed value that specifies the kind of symbol set.

symbol.weight

A DWRITE_PANOSE_WEIGHT-typed value that specifies the weight of the symbol typeface.

symbol.spacing

A DWRITE_PANOSE_SPACING-typed value that specifies the spacing of the symbol typeface.

symbol.aspectRatioAndContrast

A DWRITE_PANOSE_SYMBOL_ASPECT_RATIO-typed value that specifies the aspect ratio and contrast of the symbol typeface.

symbol.aspectRatio94

A DWRITE_PANOSE_SYMBOL_ASPECT_RATIO-typed value that specifies the aspect ratio 94 of the symbol typeface.

symbol.aspectRatio119

A DWRITE_PANOSE_SYMBOL_ASPECT_RATIO-typed value that specifies the aspect ratio 119 of the symbol typeface.

symbol.aspectRatio157

A DWRITE_PANOSE_SYMBOL_ASPECT_RATIO-typed value that specifies the aspect ratio 157 of the symbol typeface.

symbol.aspectRatio163

A DWRITE_PANOSE_SYMBOL_ASPECT_RATIO-typed value that specifies the aspect ratio 163 of the symbol typeface.

symbol.aspectRatio211

A DWRITE_PANOSE_SYMBOL_ASPECT_RATIO-typed value that specifies the aspect ratio 211 of the symbol typeface.

Remarks

Note  The familyKind member (index 0) is the only stable entry in the 10-byte array because all the entries that follow can change dynamically depending on the context of the first member.
 

Requirements

Requirement Value
Minimum supported client Windows 8 and Platform Update for Windows 7 [desktop apps only]
Minimum supported server Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps only]
Header dwrite_1.h

See also

DWRITE_PANOSE_FAMILY

IDWriteFont1::GetPanose