GetViewTransform Method

  • Article

GetViewTransform Method

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

Declaration

[C++]

HRESULT GetViewTransform(
    [in] IInkTransform* viewTransform
);

[Microsoft® Visual Basic® 6.0]

Public Sub GetViewTransform( _
    viewTransform As InkTransform _
)

Parameters

viewTransform

[in] Gets the matrix that represents the geometric transformation — rotation, scaling, shear, and reflection — values to use to transform the stroke coordinates within the ink space. The transformation applies to both the points and pen width. View transformation occurs after object transformation.

Return Value

HRESULT value Description
S_OK Success.
E_POINTER A parameter contained an invalid pointer.
E_INK_EXCEPTION An exception occurred inside the method.

Remarks

Any translations applied to this transform should be in ink space units (1 unit = .01mm).

Adjusting the view transform is analogous to adjusting the zoom factor on the ink rendering.

View transformation occurs after object transformation.

Example

[Visual Basic 6.0]

This Visual Basic 6.0 example gets the current view transform matrix from the InkRenderer object in the InkCollector, theInkCollector, so various transforms can be applied to it.

Dim theInkTransform as New InkTransform
theInkCollector.Renderer.GetViewTransform theInkTransform

Applies To