OPENTYPE_FEATURE_RECORD (Compact 2013)

3/28/2014

This structure contains information about a single OpenType feature to apply to a specific range of text in 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 more information on feature tags, see this Microsoft Web site.

• lParameter
  Value indicating how to apply the feature tag. Possible values include the following:

  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. This value should be used only when multiple alternatives are available for a feature.

Remarks

The following illustration shows one use of the OPENTYPE_FEATURE_RECORD structure. Stylistic Alternates is a registered OpenType feature, with the 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.

The feature uses GSUB lookup type 1 to substitute one single glyph for another, with lParameter indicating the chosen glyph. For more information, see this Microsoft Web site.

Requirements

Header

usp10.h

See Also

Reference

Uniscribe Structures
OPENTYPE_TAG
TEXTRANGE_PROPERTIES