SCRIPT_ANALYSIS (Windows Embedded CE 6.0)

1/6/2010

This structure describes an item, that is, a portion of a Unicode string. This structure is filled by ScriptItemize, which breaks a Unicode string into individually shapeable items. The structure also includes a copy of the Unicode algorithm state (SCRIPT_STATE).

Syntax

typedef struct tag_SCRIPT_ANALYSIS {
  WORD eScript; 
  WORD fRTL; 
  WORD fLayoutRTL; 
  WORD fLinkBefore; 
  WORD fLinkAfter; 
  WORD fLogicalOrder; 
  WORD fNoGlyphIndex; 
  SCRIPT_STATE s; 
} SCRIPT_ANALYSIS;

Members

• eScript
  Opaque value identifying which engine Uniscribe will use when calling the ScriptShape, ScriptPlace, and ScriptTextOut functions for this item. The value of eScript is undefined and will change in future releases, but attributes of eScript may be obtained by calling ScriptGetProperties.

  To disable shaping, set this parameter to SCRIPT_UNDEFINED.

• fRTL
  Rendering direction.

• fLayoutRTL
  Logical direction, whether left-to-right or right-to-left. Although this is usually the same as fRTL, for a number in a RTL run, fRTL is False (because digits are always displayed LTR), but fLayoutRTL is True (because the number is read as part of the RTL sequence).

• fLinkBefore
  If set, the shaping engine will shape the first character of this item as if it were joining with a previous character. Set by ScriptItemize, it may be overridden before calling ScriptShape.

• fLinkAfter
  If set, the shaping engine will shape the last character of this item as if it were joining with a subsequent character. Set by ScriptItemize, it may be overridden before calling ScriptShape.

• fLogicalOrder
  If set, the shaping engine will generate all glyph-related arrays in logical order. By default, glyph-related arrays are in visual order, the first array entry corresponding to the left-most glyph. Set to FALSE by ScriptItemize, it may be overridden before calling ScriptShape.

• fNoGlyphIndex
  Typically FALSE. Set to TRUE for bitmap, vector, and device fonts; and for Asian scripts. It may be set to TRUE on input to ScriptShape to disable use of glyphs for this item. Additionally, ScriptShape will set it to TRUE for an hdc containing symbolic, unrecognized, and device fonts.

  Disabling glyphing disables complex script shaping. When set, shaping and placing for this item is implemented directly by calls to GetTextExtentExPoint and ExtTextOut.

• s
  A SCRIPT_STATE structure.

Requirements

See Also

Reference

ScriptGetProperties
ScriptItemize
ScriptPlace
ScriptShape
ScriptTextOut
SCRIPT_STATE

Other Resources

Uniscribe Structures
GetTextExtentExPoint
ExtTextOut