Share via


IInkRenderer::SetViewTransform

4/8/2010

Sets the IInkTransform object that represents the view transform that is used to render ink for the IInkRenderer object.

Syntax

HRESULT SetViewTransform(
  [in] IInkTransform *viewTransform
);

Parameters

  • viewTransform
    The IInkTransform object that represents the geometric transformation — rotation, scaling, shear, and reflection — values to use to transform the stroke coordinates within the ink space.

    A NULL value for the viewTransform parameter correlates to the identity transform.

Return Value

HRESULT value Description

S_OK

Success.

E_POINTER

A parameter contained an invalid pointer.

E_INVALIDARG

viewTransform does not point to a compatible IInkTransform object.

E_INK_EXCEPTION

An exception occurred inside the method.

Remarks

The transformation applies to both the points and pen width. The pen width is calculated by multiplying the specified pen width (or default of 53, if unspecified) by the square root of the determinant of the view transform.

To retrieve the view transform, use IInkRenderer::GetViewTransform.

View transformation occurs after object transformation. For more information, see IInkRenderer::SetObjectTransform.

Requirements

Header msinkaut.h
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile 6 Classic and later, Windows Mobile 6 Professional and later

See Also

Concepts

Windows Mobile Ink Reference