百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
V

Vertx.Debugging

> 编程语言
开源

用于 Unity 的调试工具

606 stars0 点赞1 次浏览
访问官网GitHub

工具介绍

用于 Unity 的调试工具

Fast editor debugging and gizmo utilities for Unity.
Uses instanced rendering to draw shapes efficiently.

[!NOTE]
Unity 2022.2+ (all features) - Version 3.0.0 and above.
2019.4+ No jobs and burst support, older API.

Should support all render pipelines.
Supports drawing from jobs and burst. This package depends on Burst and Mathematics.
All shapes are wireframe. There is currently no support for solid shapes planned.

https://user-images.githubusercontent.com/21963717/194199755-a63d8ebc-0cc7-4268-9316-78f7d4fbea1a.mp4

Usage

Shape drawing

Example

csharp
// Draw a sphere with the specified color.
D.raw(new Shape.Sphere(position, radius), color, duration);

// Draw green sphere if nothing was hit,
// or draw a red sphere if something was.
D.raw(new Shape.Sphere(position, radius), hit, duration);

// Casts draw in green, with red where hits were detected if no color is provided.
// Cast color and hit color can be overrided manually.
D.raw(new Shape.SphereCastAll(position, direction, radius, hits, hitCount, 10), duration);

Available contexts

You can call these methods from most places, Update, LateUpdate, FixedUpdate, OnDrawGizmos, and with ExecuteAlways/ExecuteInEditMode.
If drawn from a gizmo context, duration parameters will be ignored. Gizmos.matrix works, Gizmos.color is unsupported. Gizmos are not pickable.

Code stripping

Calls to these methods are stripped when building. You do not have to remove code or use defines.
If your code spans many statements, only the method call will be stripped.

Drawing Physics and Physics2D operations

Example

You can replace calls to Physics and Physics2D methods with DrawPhysics and DrawPhysics2D to simply draw the results of a physics operation.

csharp
int count = DrawPhysics.RaycastNonAlloc(r, results, distance);

Use DrawPhysicsSettings.SetDuration or Duration to override the length of time the casts draw for. You will need to reset this value manually. Calls to Duration cannot be stripped, I would recommend using SetDuration if this is important to you.

Code stripping

The drawing within these methods will be stripped, and the original method is attempted to be inlined, but this is not consistent.
A single method call doesn't matter when compared to a physics operation, but you can completely strip these calls by instead declaring:

csharp
#if UNITY_EDITOR
using Physics = Vertx.Debugging.DrawPhysics;
#endif

[!NOTE]
Gizmos must be enabled in the view.
3D gizmos support fading, but may be inconsistent between Unity versions.

If you find you have rendering issues like upside-down depth testing, or artifacts in the game view: This is a Unity bug.
You can disable Depth Write and Depth Test in the problematic view using the settings in Project Settings > Vertx > Debugging.
If you're on a version of Unity where the settings UI doesn't work, it's another Unity bug, thanks Unity!

Shapes

Drawable shapes and casts are contained within the Shape class. You can statically import the class if you use them often:

csharp
using static Vertx.Debugging.Shape;

Shape list

General

Name Description
Text A label in the scene at the provided position. (Text respects 3D gizmo fade distance)
Not currently supported in jobs.
ScreenText A label in the top left of the view.
Draws using an Overlay in the Scene view when available.
Not currently supported in jobs.

3D

Shapes

Name Description
Sphere
Hemisphere
Box
Capsule
Cylinder 3D shapes.
Arc An arc (using Angle[^1] to define its length).
Annulus An annulus or annulus sector.
SurfacePoint A ray with a circle to indicate the surface.
Point A point without a specified direction.
Axis An XYZ direction gizmo.
Arrow
ArrowStrip An arrow vector, or a collection of points forming an arrow.
Line
LineStrip A line, or a collection of points that make up a line.
DashedLine A dashed line.
HalfArrow An arrow with only one side of its head. Commonly used to represent the HalfEdge data structure.
Arrow2DFromNormal An 2D arrow aligned in 3D space using a normal vector perpendicular to the direction.
Plane A 3D rect drawn around a point on the plane.
Cone A cone (with adjustable end radius, making a conical frustum).
Pyramid A pyramid.
Frustum A camera frustum.
FieldOfView A 3D field of view, a spherical sector.
MeshNormals The normals of a mesh.
Catenary Similar to cable hanging between two points.
Ray A line from a position and a direction vector.
Ray (Built-in) Fallback to Ray.
Vector3 (Built-in) Fallback to Point.
RaycastHit (Built-in) Fallback to SurfacePoint.
Bounds (Built-in) Fallback to Box.
Collider (Built-in) Fallback to the correct shape matching the collider type (primitive colliders only).

Casts

Name Description
Raycast
Linecast
SphereCast
BoxCast
CapsuleCast Using similar parameters as
Physics.Raycast
Physics.Linecast
Physics.SphereCast
Physics.BoxCast
Physics.CapsuleCast
with an optional RaycastHit result.
RaycastAll
SphereCastAll
BoxCastAll
CapsuleCastAll RaycastHit[] results using similar parameters as
Physics.RaycastAll
Physics.SphereCastAll
Physics.BoxCastAll
Physics.CapsuleCastAll

2D

Shapes

Name Description
Circle2D
Box2D
Area2D
Capsule2D
Rect 2D shapes.
Arc2D An arc (using Angle[^1] to define its length).
Point2D A point without a specified direction.
Axis2D An XY direction gizmo.
Arrow2D
ArrowStrip2D An arrow vector, or a collection of points forming an arrow.
Ray2D A line from a position and a direction vector.
Spiral2D A spiral, useful for visualising rotation on wheels.
Vector2 (Built-in) Fallback to Point2D.
RaycastHit2D (Built-in) Fallback to Ray.
Rect (Built-in) Fallback to Box2D.

Casts

Name Description
Raycast2D
Linecast2D
CircleCast2D
BoxCast2D
CapsuleCast2D Using similar parameters as
Physics2D.Raycast
Physics2D.Linecast
Physics2D.SphereCast
Physics2D.BoxCast
Physics2D.CapsuleCast
with an optional RaycastHit2D result.
RaycastAll2D
CircleCastAll2D
BoxCastAll2D
CapsuleCastAll2D RaycastHit2D[] results using similar parameters as
Physics2D.RaycastAll
Physics2D.SphereCastAll
Physics2D.BoxCastAll
Physics2D.CapsuleCastAll

[^1]: The helper class Angle is used to define angles, author it with the static me

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

C#debuggizmosunityunity3d

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言