Share via


IXRPlaneProjection::GetLocalOffsetZ (Compact 7)

3/12/2014

This method retrieves the translation distance of the object along its own z-axis.

Syntax

virtual HRESULT STDMETHODCALLTYPE GetLocalOffsetZ(
    float* pLocalOffsetZ
) = 0;

Parameters

  • pLocalOffsetZ
    [out] Pointer to the translation distance of the object along its z-axis.

Return Value

Returns an HRESULT that indicates success or failure.

Remarks

In contrast to global offsets, which translate an object along the axes of the viewing screen, local offset properties translate an object along its own axes. After the object is rotated, its plane no longer matches the plane of the screen. Therefore, the rotation of the object determines the direction in which it is translated. For example, if the object is rotated by using IXRPlaneProjection::SetRotationY, a translation along the local z-axis makes the object appear to move toward you to the right or left, while a translation along the global z-axis still makes the object appear to move directly toward you.

To move an object in the three-dimensional space of the object, use IXRPlaneProjection::SetLocalOffsetX, IXRPlaneProjection::SetLocalOffsetY, and IXRPlaneProjection::SetLocalOffsetZ.

.NET Framework Equivalent

System.Windows.Media.PlaneProjection.LocalOffsetZ

Requirements

Header

XamlRuntime.h

sysgen

SYSGEN_XAML_RUNTIME

See Also

Reference

IXRPlaneProjection