IPlacement2D Interface Reference

Represents a local coordinate system in two-dimensional space. More...

Public Member Functions
HRESULT	GetCopy ([out, retval] IPlacement2D **ppCopy)
	Returns a copy of the coordinate system.
HRESULT	GetTransformFrom ([out, retval] ITransform2D **ppTransform)
	Returns the transform from the current coordinate system to the global (in relation to the current) coordinate system.
HRESULT	GetTransformInto ([out, retval] ITransform2D **ppTransform)
	Returns the transform from the global (in relation to the current) coordinate system to the current coordinate system.
HRESULT	IsLeft ([out, retval] VARIANT_BOOL *pResult)
	Checks whether the coordinate system is left.
HRESULT	IsNormal ([out, retval] VARIANT_BOOL *pResult)
	Checks whether the coordinate system is normalized (axes are unit vectors).
HRESULT	IsOrthogonal ([out, retval] VARIANT_BOOL *pResult)
	Checks whether the coordinate system is orthogonal (axes are perpendicular).
HRESULT	Move ([in] Vector2D vector_)
	Moves the coordinate system by the given vector.
HRESULT	Rotate ([in] Point2D point_, [in] double angle_)
	Rotates the coordinate system counterclockwise by a given angle around a given point.
HRESULT	Transform ([in] ITransform2D *pTransform)
	Transformes the coordinate system according to a given transform.

Properties
Vector2D	AxisX [get]
	The X axis vector of the coordinate system.
Vector2D	AxisY [get]
	The Y axis vector of the coordinate system.
Point2D	Origin [get]
	The origin of the coordinate system.
Placement2D	Placement [get]
	The placement as a Placement2D struct.

Detailed Description

Represents a local coordinate system in two-dimensional space.

A local coordinate system is described by an origin point and two non-collinear axis vectors.

See also

IMath::CreatePlacement2D

Member Function Documentation

GetTransformFrom()

HRESULT GetTransformFrom

(

[out, retval] ITransform2D **

ppTransform

)

Returns the transform from the current coordinate system to the global (in relation to the current) coordinate system.

See also

ITransform2D

GetTransformInto()

HRESULT GetTransformInto

(

[out, retval] ITransform2D **

ppTransform

)

Returns the transform from the global (in relation to the current) coordinate system to the current coordinate system.

See also

ITransform2D

IsLeft()

HRESULT IsLeft

(

[out, retval] VARIANT_BOOL *

pResult

)

Checks whether the coordinate system is left.

Returns

TRUE if coordinate system is left, FALSE otherwise.

IsNormal()

HRESULT IsNormal

(

[out, retval] VARIANT_BOOL *

pResult

)

Checks whether the coordinate system is normalized (axes are unit vectors).

Returns

TRUE if coordinate system is normalized, FALSE otherwise.

IsOrthogonal()

HRESULT IsOrthogonal

(

[out, retval] VARIANT_BOOL *

pResult

)

Checks whether the coordinate system is orthogonal (axes are perpendicular).

Returns

TRUE if coordinate system is orthogonal, FALSE otherwise.

Move()

HRESULT Move

(

[in] Vector2D

vector_

)

Moves the coordinate system by the given vector.

Parameters

[in]

vector_

The vector that the placement will be moved to.

Rotate()

HRESULT Rotate	(	[in] Point2D	point_,
		[in] double	angle_ )

Rotates the coordinate system counterclockwise by a given angle around a given point.

Parameters

[in]	point_	The point around which the placement will be rotated.
[in]	angle_	The rotation angle in radians.

Transform()

HRESULT Transform

(

[in] ITransform2D *

pTransform

)

Transformes the coordinate system according to a given transform.

Parameters

[in]

pTransform

The transformation that will be applied to the placement.

See also

ITransform2D