IInkRenderer::SetViewTransform method (msinkaut.h)

Article
10/13/2021

Sets the InkTransform object that represents the view transform that is used to render ink.

Syntax

HRESULT SetViewTransform(
  [in] IInkTransform *ViewTransform
);

Parameters

[in] ViewTransform

The InkTransform 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

This method can return one of these values.

Return code	Description
S_OK	Success.
E_POINTER	A parameter contained an invalid pointer.
E_INVALIDARG	viewTransform does not point to a compatible InkTransform object.
E_INK_EXCEPTION	An exception occurred inside the method.

Remarks

The transformation applies to both the points and pen width.

View transformation occurs after object transformation.

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.

It is problematic to call this method in response to SENT message. Test whether you are processing a SENT message by calling InSendMesssageEx and then POST the message to yourself if the message was SENT.

Requirements

Requirement	Value
Minimum supported client	Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	msinkaut.h
Library	InkObj.dll