CoordinateReorder converts coordinate values between different axis orders. It can reorder axes, invert axes, apply offsets, and optionally output nil for selected axes.
Usage
Use CoordinateReorder when values from one coordinate system need to be mapped into another axis order before they are passed on to the next Control module or Direct API call.
The module expects input values in complete groups of three:
-
x, y, zfor position only -
x, y, z, rx, ry, rzfor position and rotation
Additional values after the first six inputs are passed through unchanged.
Procedure
- Set
Input Formatto the order of the incoming axes. - Set
Output Formatto the desired outgoing axis order. - Configure position and rotation axis options as needed:
-
Invertmultiplies the selected axis by-1. -
Offsetadds the configured value after reordering and inversion. -
Excludeoutputsnilfor the selected axis.
- Connect node based input values to
convert
If fewer than three values are provided, CoordinateReorder logs an error and does not call connected references.
Exclude flags do not reduce the required input count. For example, even if Exclude Z is enabled, still provide x, y, z. With rotation, still provide all six values x, y, z, rx, ry, rz.
Data
Actions
| Action | Info | Input | Output |
|---|---|---|---|
| convert | Converts incoming coordinate values according to the selected input/output axis formats, invert flags, offsets, and exclude flags. | ... |
Converted values via pixc.callRefs
|
| dropdownInputs | Provides available values for Input Format. |
- |
xyz, xzy, yxz, yzx, zxy, zyx
|
| dropdownOutputs | Provides available values for Output Format. |
- |
xyz, xzy, yxz, yzx, zxy, zyx
|
Properties
| Name | Content | Type Hint | Options Source | Options Action |
|---|---|---|---|---|
| Input Format | xyz | string | self.dropdownInputs | [] |
| Output Format | xyz | self.dropdownOutputs | [] | |
| Offset X | 0 | number | [] | |
| Exclude X | false | bool | [] | |
| Invert X | false | bool | [] | |
| Offset Y | 0 | number | [] | |
| Exclude Y | false | bool | [] | |
| Invert Y | false | bool | [] | |
| Offset Z | 0 | number | [] | |
| Exclude Z | false | bool | [] | |
| Invert Z | false | bool | [] | |
| Offset rotation X | 0 | number | [] | |
| Exclude rotation X | false | bool | [] | |
| Invert rotation X | false | bool | [] | |
| Offset rotation Y | 0 | number | [] | |
| Exclude rotation Y | false | bool | [] | |
| Invert rotation Y | false | bool | [] | |
| Offset rotation Z | 0 | number | [] | |
| Exclude rotation Z | false | bool | [] | |
| Invert rotation Z | false | bool | [] | |
| Description | This Module provides coordinate system conversion, including axis reordering and inversion. It is fully compatible with the Direct API. This Module assumes inputs in groups of three, e.g. x,y,z or x,y,z,rx,ry,rz. Exclude flags output nil for the selected axes; still provide the full 3 or 6 input values. Offsets are applied after conversion. | [] | ||
| Author | AV Stumpfl GmbH | string | [] | |
| Logo | image | [] | ||
| Documentation | 3876190 | documentation | [] | |
| Version | 1.4 | string | [] |
Changelog
Initial documentation for CoordinateReorder.
Module Version 1.4 | 9 July 2026 | AV Stumpfl GmbH
