 | Reference |
Represents a reference coordinate system object in the woodwork automation manufacturing system.
A reference coordinate system manages coordinate system transformations through matrix operations that map between global
(world) coordinates and custom workpiece-relative coordinates. It supports alignment to predefined clamping
positions and workpiece sides by name, custom alignment through explicit X and Y axis vectors, and flexible
origin repositioning through vector shifts or explicit point definitions. The reference system maintains an
internal transformation matrix that encapsulates the complete spatial mapping, enabling seamless coordinate
conversions essential for multi-sided machining workflows, complex feature alignment, and precise tool positioning
relative to dynamically changing workpiece orientations throughout the CNC manufacturing process.
Namespace: Woodwork.Automation
Assembly: WoodworkAutomation (in WoodworkAutomation.dll) Version: 10.2.1+e3fd5885edfa7211ba46258e0eed5ac221a54381
SyntaxThe ReferenceCoordinateSystem type exposes the following members.
Properties| Name | Description | |
|---|---|---|
 | CurrentTransformation | Gets or sets the transformation matrix that defines the complete spatial mapping from global to reference coordinates. This property is for internal system usage and encapsulates all translation, rotation, and alignment operations applied to the reference coordinate system. |
Methods| Name | Description | |
|---|---|---|
 | AlignTo | Aligns the reference coordinate system to a custom orientation defined by explicit X and Y axis vectors. The X and Y axis vectors establish the primary and secondary horizontal directions for the custom coordinate frame. The Z-axis is computed automatically from the cross product of the X and Y axes to ensure orthogonality. |
| SetNewCoordinateSystem | Replaces the reference coordinate system with a completely new coordinate system. This method sets the reference frame to use the specified coordinate system's origin, axes, and spatial properties, effectively redefining the entire reference frame for subsequent operations. |
| SetNewOrigin(Point) | Defines an absolute new origin point for the reference coordinate system. The reference system's origin is relocated to the specified point in global coordinates while preserving the coordinate system's current axis orientation and transformations. |
| SetNewOrigin(Vector) | Shifts the origin of the reference coordinate system by the specified displacement vector. The shift translation moves the origin point along the direction and magnitude specified by the shift vector while preserving the coordinate system's axis orientation. |
| SetToClamping | Aligns the reference coordinate system to a clamping position identified by the specified clamping name. The reference system adopts the spatial origin, axes, and orientation associated with the named clamping configuration. |
| SetToSide(String) | Aligns the reference coordinate system to a workpiece side identified by the specified side name. The reference system adopts the coordinate frame of the named workpiece face or side. |
| SetToSide(Vector) | Aligns the reference coordinate system to a workpiece side by its surface normal vector. The normal vector specifies the perpendicular direction to the workpiece face, establishing the Z-axis orientation for the reference coordinate system aligned to that side. |
See Also