This function supplies type to the Typesetter of the specified Standard Engine instance. Type is a set of typographical properties that are applied to the glyphs/characters during rendering. These properties are:
This function is very similar to TypesetterSetTypeEffects. However, TypesetterSetTypeEffectsTransformed allows application to apply an additional two-dimensional transformation matrix to the existing transformation within the DT_TYPE_ATTRIBS structure before the resulting transformation is supplied to the Typesetter.
Parameter | Description |
---|---|
type | |
transform |
An additional transformation matrix to apply to the existing transformation supplied with the type attribute and defined by DT_TM2X2. If transform is set to DV_NULL, no additional transformation is applied and the function has the same effect as TypesetterSetTypeEffects. |
flag |
A hint to the Typesetter describing application's preference in handling the resulting transformation and whether it should return the resulting transformation back to the application by updating the type parameter. The following values are supported: flag = 0 — always set the resulting transformation using a two-dimensional matrix representation; do not update the type parameter upon return flag = 1 — if the resulting transformation is trivial (e.g. simple scale or skew), use raw transformation parameters rather than a two-dimensional matrix; do not update the type parameter upon return flag = 2 — always set the resulting transformation using a two-dimensional matrix representation; then return the resulting transformation back to the application by updating the type parameter flag = 3 — if the resulting transformation is trivial (e.g. simple scale or skew), use raw transformation parameters rather than a two-dimensional matrix; then return the resulting transformation back to the application by updating the type parameter |
reserved |
Reserved for future use. Must be set to 0. |
Raw transformation parameters will produce a better and sharper looking glyphs/characters than a two-dimensional matrix. Therefore, we recommend setting the flag parameter to 1 or 3.