This Unity package improves the Inspector of Transform components by integrating a powerful expression engine that gives you more control over selected objects. Now you can for example:
- Add to each object's current x-position
- Separate objects by a uniform distance
- Swap x- and y-rotations
- Arrange objects in a circle
- Scale objects randomly
- And much more...
Installation
In your project folder, simply add this to the dependencies inside Packages/manifest.json:
"com.d4ku.better-transform-inspector": "https://github.com/D4KU/unity-better-transform-inspector.git"
Alternatively, you can:
- Clone this repository
- In Unity, go to
Window>Package Manager>+>Add Package from disk - Select
package.jsonat the root of the package folder
Unity should automatically load the package. After the successful installation you should see additional input fields for world space coordinates in the inspector of a Transform component.
Usage
The Inspector accepting extended expressions, named the Expressive Inspector, works a bit differently from the default Transform Inspector. To support value swapping and ease formula editing, the shown values are not updated by other operations manipulating the respective Transform, such as scene gizmos. As soon as the Inspector is shown, the initial transformation is stored for any variable or function to reference it.
Because this behaviour is unfavorable in most situations, the Expressive Inspector must be activated manually via the context menu of a Transform component. To refresh the stored transformation, change the selection or toggle the Expressive Inspector via this menu.
What follows is a comprehensive list of variables and functions that can be
used with the Expressive Inspector. Of course the standard infix operators
+-*/ for addition, subtraction, multiplication, and division are also
supported.
Variables
| Name | Description |
|---|---|
| x/y/z | x/y/z-coordinate of the edited vector (position/rotation/scale) * |
| px/py/pz | x/y/z-coordinate of the object's position * |
| rx/ry/rz | x/y/z-coordinate of the object's rotation * |
| sx/sy/sz | x/y/z-coordinate of the object's scale * |
| i | The object's index in the list of selected objects |
| j | The object's sibling index |
| n | The object's number suffix (e.g. 1 in GameObject (1)) |
| l | The number of selected objects |
| c | The object's child count |
| r | Random value in the range [0, 1] |
| pi | pi constant |
| e | e constant |
Functions
| Signature | Return value |
|---|---|
| x(n) | n'th selected object's x-coordinate of the edited vector. Likewise for y and z. * |
| px(n) | n'th selected object's x-position. Likewise for y and z. * |
| rx(n) | n'th selected object's x-rotation. Likewise for y and z. * |
| sx(n) | n'th selected object's x-scale. Likewise for y and z. * |
| abs(x) | Absolute value of x |
| sqrt(x) | Square root of x |
| pow(x, y) | x to the power of y |
| mod(x, y) | Remainder of x / y |
| log(x) | Natural logarithm of x |
| log(x, y) | Logarithm of x to the base of y |
| trunc(x) | Integral part of x |
| frac(x) | Fractional part of x |
| sign(x) | -1 if x is negative, 1 otherwise |
| step(x, y) | 1 if x >= y, 0 otherwise |
| round(x) | Rounded value of x |
| floor(x) | Rounded down value of x |
| ceil(x) | Rounded up value of x |
| clamp(x, a, b) | x clamped to range [a, b] |
| quant(x, y) | Quantize: largest multiple of y <= x |
| min(...) | Minimum of all passed arguments |
| max(...) | Maximum of all passed arguments |
| avg(...) | Average of all passed arguments |
| sin(x) | Sine of x |
| cos(x) | Cosine of x |
| tan(x) | Tangent of x |
| asin(x) | Arcsine of x |
| acos(x) | Arccosine of x |
| atan2(x, y) | Arctangent of x |
| pyth(a, b) | Pythagorean equation: sqrt(a * a + b * b) |
| rand(a, b) | Random value in the range [a, b] |
* Lower case x, y, z returns the local coordinate in the local space Inspector and the global coordinate in the world space Inspector. An upper case character returns the coordinate from the other space respectively.