Description
Return dimensions in the requested label order.
Layout calculations relate dimensions, offsets, and normalized positions in a drawing or display. A numeric coordinate depends on its origin and scale, while a size allowance must use the same length unit as the object.
Return dimensions in the requested label order.
When to use this tool
Use Art Object Dimension Axis Order when you need a stated layout component from supplied dimensions or a normalized position.
How to use the tool and how it works
- Enter axisLabels, dimensions, requestedOrder. Keep parallel arrays aligned. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read orderedDimensions. Use the output convention below.
Require aligned axisLabels, dimensions, and requestedOrder, with unique labels and requested axes and nonnegative dimensions. Return dimensions in the requested label order.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| axisLabels | Axis Labels | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| dimensions | Dimensions | Required. Array of finite number; maximum items 256. |
| requestedOrder | Requested Order | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| orderedDimensions | Ordered Dimensions | Required. Array of finite number; maximum items 256. |
{
"input": {
"axisLabels": [
"width",
"height",
"depth"
],
"dimensions": [
50,
70,
4
],
"requestedOrder": [
"height",
"width",
"depth"
]
},
"output": {
"orderedDimensions": [
70,
50,
4
]
}
}Limitations and assumptions
- This permutes literal axes without converting units, interpreting height/width/depth conventions, or measuring an object.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
- Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.
Alternative or Complementary methods
Check the assembled layout at its final scale and include installation or production allowances separately.
References
Similar or alternative tools
- Artwork Framed Unframed Dimension Delta
Return added width/height and halve each addition for average opposing borders.
- Vector Coordinate Axis Permutation
Select coordinates in permutation order.