This topic has not yet been rated - Rate this topic

OPENTYPE_FEATURE_RECORD structure

Contains information about a single OpenType feature to apply to a run.

Syntax


typedef struct opentype_feature_record {
  OPENTYPE_TAG tagFeature;
  LONG         lParameter;
} OPENTYPE_FEATURE_RECORD;

Members

tagFeature

OPENTYPE_TAG structure containing a registered or private OpenType feature tag. For information on feature tags, see http://www.microsoft.com/typography/otspec/featuretags.htm.

lParameter

Value indicating how to apply the feature tag. Possible values are defined in the following table.

Value	Description
0	Feature is disabled and should not be applied.
1	Feature is active. If the feature offers several alternatives, select the first value.
Greater than 1	Feature is active. Select the alternative value at this index. Should be used only when multiple alternatives are available for a feature.

Examples

Stylistic Alternates is a registered OpenType feature, with feature tag "salt". To describe a substitution based on this feature, the tagFeature member of the OPENTYPE_FEATURE_RECORD structure contains the value "salt", consisting of four 8-bit ASCII characters. Consider using this feature to apply stylistic alternates for an ampersand, as shown in the following illustration.

Illustration showing an ampersand character, and four alternate ways of drawing that characters

The feature uses GSUB lookup type 1 to substitute one single glyph for another, with the lParameter member of this structure indicating the chosen glyph. For more information, see GSUB - The Glyph Substitution Table.

Requirements

Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Redistributable	Usp10.dll version 1.600 or greater onWindows XP
Header	Usp10.h

Community Additions