Highly efficient gizmo drawer for Unity.

日本語版

UGizmo is a library that adds various features to the standard Gizmos class and allows calls at runtime and the Unity event functions. Also, by using GPU instancing to reduce draw calls, you can draw gizmos efficiently.

• Available to be called by event functions such as Update(), LateUpdate(), etc.
• Runtime support
• Draw call optimization using GPU instancing
• More than 30 gizmos
• Can be made zero-cost in release builds (draw calls are stripped at the IL level)
• Optional depth testing so gizmos can be occluded by scene geometry

Using Standard Gizmos

Using UGizmos

All UGizmos.DrawXXX calls are marked with [Conditional], so the compiler can remove them at the IL level. The call and its arguments are never emitted, so there is no runtime cost and no JIT — you can leave gizmo calls in your gameplay code without guarding them with #if.

Draw calls are kept in the following cases (any one is enough):

Gizmos are therefore on by default in release builds too. To strip them and get the zero-cost behaviour, untick Tools > UGizmo > Keep Gizmos in Release Builds. The menu adds or removes the UGIZMO symbol for the build target currently selected in Build Settings, so you never have to type it into Scripting Define Symbols by hand.

By default, gizmos ignore what is in front of them: wireframes and points always draw on top, and solid primitives show their occluded parts faintly. Set UGizmos.depthTest = true to make every gizmo respect the scene depth buffer instead, so anything behind other geometry is simply not drawn.

UGizmos.depthTest = true;

It is a global switch — there is no per-draw-call option. false restores the default look described above.

• Unity 2021.3 or higher
• Built-in Render Pipeline, URP, or HDRP

You can enter the following link in the Package Manager of Unity

https://github.com/harumas/UGizmo.git?path=src/UGizmo/Assets/UGizmo

or open Packages/manifest.json and add the following to the dependencies block

{
    "dependencies": {
        "com.harumaro.ugizmo": "https://github.com/harumas/UGizmo.git?path=src/UGizmo/Assets/UGizmo"
    }
}

It can be drawn by using the UGizmos class.
In the standard Gizmos class, the matrix is specified using Gizmos.matrix, but in UGizmo, the position, rotation, and scale information is passed as method arguments. Also, the color should not be specified using Gizmos.color, but directly passing the Color structure as the method argument.

using UnityEngine;

public class DrawCubeSample : MonoBehaviour
{
    private void OnDrawGizmos()
    {
        UGizmos.DrawCube(Vector3.zero, Quaternion.Euler(45f, 45f, 45f), Vector3.one, Color.red);
    }
}

Open Package Manager > UGizmo > Samples to install the samples:

OnDrawGizmos works, but it is editor-only, and it runs after UGizmo has already collected the frame, so its gizmos appear one frame late. Subscribe to UGizmos.OnDraw instead when that matters — it fires once per frame from inside the render loop, with no lag, and works the same in play mode, edit mode and builds.

using UnityEngine;

[ExecuteAlways]
public class DrawCubeSample : MonoBehaviour
{
    private void OnEnable() => UGizmos.OnDraw += Draw;
    private void OnDisable() => UGizmos.OnDraw -= Draw;

    private void Draw(Camera camera)
    {
        UGizmos.DrawCube(Vector3.zero, Quaternion.Euler(45f, 45f, 45f), Vector3.one, Color.red);
    }
}

Drawing from Update or LateUpdate also has no lag, because both run before rendering.

UGizmos.enabled disables all tracking and rendering at runtime, without touching your draw calls.

This library is released under the MIT License. MIT License