Gets the rotation value of the specified character, relative to the current user coordinate system where the glyphs that corresponding to the specified character are rendered.
HRESULT getRotationOfChar( long charnum, float *pResult );
- [in] The index of the character, where the first character has an index of 0.
- [out, retval] The rotation angle.
Returns S_OK if successful, or an error value otherwise.
If multiple glyphs are used to render the specified character and if the glyphs each have different rotations (for example, because of text-on-a-path), the ISVGTextContentElement::getRotationOfChar method returns an average value (that is, the rotation angle at the midpoint along the path for all glyphs that are used to render the specified character).
The rotation value represents the rotation that is supplemental to any rotation because of the IHTMLCSSStyleDeclaration::glyphOrientationHorizontal and IHTMLCSSStyleDeclaration::glyphOrientationVertical properties. Any glyph rotations because of these properties are not included in the returned rotation value.
If multiple consecutive characters are rendered inseparably (for example, as a single glyph or a sequence of glyphs), each of the inseparable characters returns the same rotation value.