KernelCAD Documentation

Describes an axis in the plane (2D space).
An axis is defined by:
- its origin (also referred to as its "Location point"), and
- its unit vector (referred to as its "Direction").
An axis implicitly defines a direct, right-handed
coordinate system in 2D space by:
- its origin,
- its "Direction" (giving the "X Direction" of the coordinate system), and
- the unit vector normal to "Direction" (positive angle
measured in the trigonometric sense).
An axis is used:
- to describe 2D geometric entities (for example, the
axis which defines angular coordinates on a circle).
It serves for the same purpose as the STEP function
"axis placement one axis", or
- to define geometric transformations (axis of
symmetry, axis of rotation, and so on).
Note: to define a left-handed 2D coordinate system, use gp_Ax22d.

Query IKO_Standard_Object from this interface to create a copy or obtain the type name

Methods

Init

_CSFDB_Getgp_Ax2dvdir

HRESULT Init()

Creates an axis object representing X axis of
the reference co-ordinate system.

HRESULT Init1(KC2D* P, KC2D* V)

Creates an Ax2d. P is the "Location" point of
the axis placement and V is the "Direction" of
the axis placement.

HRESULT SetLocation(KC2D* Locat)

Changes the "Location" point (origin) of me.

HRESULT SetDirection(KC2D* V)

Changes the direction of me.

HRESULT Location(KC2D* ret)

Returns the origin of me.

HRESULT Direction(KC2D* ret)

Returns the direction of me.

HRESULT IsCoaxial(IKO_gp_Ax2d* Other, double AngularTolerance, double LinearTolerance, VARIANT_BOOL* ret)

HRESULT IsNormal(IKO_gp_Ax2d* Other, double AngularTolerance, VARIANT_BOOL* ret)

Returns true if this axis and the axis Other are normal to
each other. That is, if the angle between the two axes is equal to Pi/2 or -Pi/2.
Note: the tolerance criterion is given by AngularTolerance.

HRESULT IsOpposite(IKO_gp_Ax2d* Other, double AngularTolerance, VARIANT_BOOL* ret)

Returns true if this axis and the axis Other are parallel,
and have opposite orientations. That is, if the angle
between the two axes is equal to Pi or -Pi.
Note: the tolerance criterion is given by AngularTolerance.

HRESULT IsParallel(IKO_gp_Ax2d* Other, double AngularTolerance, VARIANT_BOOL* ret)

Returns true if this axis and the axis Other are parallel,
and have either the same or opposite orientations. That
is, if the angle between the two axes is equal to 0, Pi or -Pi.
Note: the tolerance criterion is given by AngularTolerance.

HRESULT Angle(IKO_gp_Ax2d* Other, double* ret)

Computes the angle, in radians, between this axis and
the axis Other. The value of the angle is between -Pi and Pi.

HRESULT Reverse()

HRESULT Reversed(IKO_gp_Ax2d** ret)

Computes a new axis placement with a direction opposite to
the direction of me.

HRESULT Mirror(KC2D* P)

HRESULT Mirrored(KC2D* P, IKO_gp_Ax2d** ret)

HRESULT Mirror1(IKO_gp_Ax2d* A)

HRESULT Mirrored1(IKO_gp_Ax2d* A, IKO_gp_Ax2d** ret)

HRESULT Rotate(KC2D* P, double Ang)

HRESULT Rotated(KC2D* P, double Ang, IKO_gp_Ax2d** ret)

Rotates an axis placement. P is the center of the
rotation . Ang is the angular value of the rotation
in radians.

HRESULT Scale(KC2D* P, double S)

HRESULT Scaled(KC2D* P, double S, IKO_gp_Ax2d** ret)

Applies a scaling transformation on the axis placement.
The "Location" point of the axisplacement is modified.
The "Direction" is reversed if the scale is negative.

HRESULT Transform(IKO_gp_Trsf2d* T)

HRESULT Transformed(IKO_gp_Trsf2d* T, IKO_gp_Ax2d** ret)

Transforms an axis placement with a Trsf.

HRESULT Translate(KC2D* V)

HRESULT Translated(KC2D* V, IKO_gp_Ax2d** ret)

Translates an axis placement in the direction of the vector
V. The magnitude of the translation is the vector's magnitude.

HRESULT Translate1(KC2D* P1, KC2D* P2)

HRESULT Translated1(KC2D* P1, KC2D* P2, IKO_gp_Ax2d** ret)

Translates an axis placement from the point P1 to the
point P2.

HRESULT _CSFDB_Getgp_Ax2dloc(KC2D* ret)

HRESULT _CSFDB_Getgp_Ax2dvdir(KC2D* ret)