unity-better-transform-inspector

KO | EN

gitlite — search

#hacktoberfest #ai #golang #deep-learning #linux #docker #macos #java #nodejs #awesome #kubernetes #vue #openai #open-source

unity-better-transform-inspector

(★ 14)

Improve Unity's Inspector for Transform components

unity-better-transform-inspector Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![](https://github.com/D4KU/unity-better-transform-inspector/blob/main/Media%7E/BetterTransformInspector.gif)

</div>

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.json` at 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](https://docs.unity3d.com/ScriptReference/Transform.GetSiblingIndex.html) |
| n | The object's number suffix (e.g. *1* in *GameObject (1)*) |
| l | The number of selected objects |
| c | The object's [child count](https://docs.unity3d.com/ScriptReference/Transform-childCount.html) |
| r | [Random value](https://docs.unity3d.com/ScriptReference/Random-value.html) in the range [0, 1] |
| pi | [pi](https://learn.microsoft.com/en-us/dotnet/api/system.math.pi) constant |
| e | [e](https://learn.microsoft.com/en-us/dotnet/api/system.math.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](https://learn.microsoft.com/en-us/dotnet/api/system.math.abs) of x |
| sqrt(x) | [Square root](https://learn.microsoft.com/en-us/dotnet/api/system.math.sqrt) of x |
| pow(x, y) | [x to the power of y](https://learn.microsoft.com/en-us/dotnet/api/system.math.pow) |
| mod(x, y) | [Remainder](https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/language-specification/expressions#12104-remainder-operator) of x / y |
| log(x) | [Natural logarithm](https://learn.microsoft.com/en-us/dotnet/api/system.math.log) of x |
| log(x, y) | [Logarithm](https://learn.microsoft.com/en-us/dotnet/api/system.math.log) of x to the base of y |
| trunc(x) | [Integral part](https://learn.microsoft.com/en-us/dotnet/api/system.math.truncate) of x |
| frac(x) | Fractional part of x |
| sign(x) | [-1 if x is negative, 1 otherwise](https://learn.microsoft.com/en-us/dotnet/api/system.math.sign) |
| step(x, y) | 1 if x >= y, 0 otherwise |
| round(x) | [Rounded value](https://learn.microsoft.com/en-us/dotnet/api/system.math.round) of x |
| floor(x) | [Rounded down value](https://learn.microsoft.com/en-us/dotnet/api/system.math.floor) of x |
| ceil(x) | [Rounded up value](https://learn.microsoft.com/en-us/dotnet/api/system.math.ceiling) of x |
| clamp(x, a, b) | x clamped to range [a, b] |
| quant(x, y) | Quantize: largest multiple of y <= x |
| min(...) | [Minimum](https://learn.microsoft.com/en-us/dotnet/api/system.linq.enumerable.min) of all passed arguments |
| max(...) | [Maximum](https://learn.microsoft.com/en-us/dotnet/api/system.linq.enumerable.max) of all passed arguments |
| avg(...) | [Average](https://learn.microsoft.com/en-us/dotnet/api/system.linq.enumerable.average) of all passed arguments |
| sin(x) | [Sine](https://learn.microsoft.com/en-us/dotnet/api/system.math.sin) of x |
| cos(x) | [Cosine](https://learn.microsoft.com/en-us/dotnet/api/system.math.cos) of x |
| tan(x) | [Tangent](https://learn.microsoft.com/en-us/dotnet/api/system.math.tan) of x |
| asin(x) | [Arcsine](https://learn.microsoft.com/en-us/dotnet/api/system.math.asin) of x |
| acos(x) | [Arccosine](https://learn.microsoft.com/en-us/dotnet/api/system.math.acos) of x |
| atan2(x, y) | [Arctangent](https://learn.microsoft.com/en-us/dotnet/api/system.math.atan2) of x |
| pyth(a, b) | [Pythagorean equation](https://en.wikipedia.org/wiki/Pythagorean_theorem): sqrt(a * a + b * b) |
| rand(a, b) | [Random value](https://docs.unity3d.com/ScriptReference/Random.Range.html) 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.

unity-better-transform-inspector

unity-better-transform-inspector Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

unity-better-transform-inspector

unity-better-transform-inspector Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README