mirror of
https://github.com/DCFApixels/Unity-DebugX.git
synced 2025-09-17 17:34:35 +08:00
Многофункциональная, расширяемая и производительная утилита рисования Gizmos для Unity. Работает как в редакторе так и в билде, а рисовать можно и в Update.
Editor | ||
Runtime | ||
Samples | ||
.gitattributes | ||
.gitignore | ||
DebugX.asmdef | ||
DebugX.asmdef.meta | ||
Editor.meta | ||
LICENSE | ||
LICENSE.meta | ||
package.json | ||
package.json.meta | ||
README.md | ||
README.md.meta | ||
Runtime.meta | ||
Samples.meta |
Unity-DebugX
Многофункциональный, расширяемый и высоко производительный инструмент для рисования Gizmos для Unity.
API для рисования заготовленные Gizmo:
DebugX.Draw(duration, color).*Gizmo Function*(...);
API для рисования кастомного меша и материала:
//Рисования любого меша lit материалом. Без GPU instancing.
DebugX.Draw(...).Mesh(mesh, pos, rot, sc);
//UnlitMesh - меш с unlit материалом
//WireMesh - меш с wireframe материалом
//Рисования статического меша lit материалом. В режиме GPU instancing.
DebugX.Draw(...).Mesh<IStaticMesh>(pos, rot, sc);
//Рисования статического меша статическим материалом. В режиме GPU instancing.
DebugX.Draw(...).Mesh<IStaticMesh, IStaticMat>(pos, rot, sc);
Для оптимизации отрисовки используются статические данные:
// Статический меш.
public struct SomeMesh : IStaticMesh
{
public Mesh GetMesh() => StaticStorage.SomeMesh;
}
// Статический материал.
public struct SomeMesh : IStaticMesh
{
public int GetExecutuonOrder() => 100;
public Mesh GetMaterial() => StaticStorage.SomeMaterial;
}
Утилита для загрузки мешей: //TODO
Кастомная реализация Gizmo:
public readonly struct SomeGizmo : IGizmo<SomeGizmo>
{
// data...
public SomeGizmo(/*...*/)
{
//...
}
public IGizmoRenderer<SomeGizmo> RegisterNewRenderer() => new Renderer();
private class Renderer : IGizmoRenderer<SomeGizmo>
{
// Контроль порядка выполнения рендереров.
public int ExecuteOrder => //...
// Флаг системе о способе оптимизации. Если метод рисовки или подготовки зависят от текущей камеры, то false,иначе true. Если не уверены то выбирайте false.
public bool IsStaticRender => //...
// Подготовка данных перед рендером, тут можно выполнить дополнительные расчеты или запланировать Job.
public void Prepare(Camera camera, GizmosList<SomeGizmo> list)
{
foreach (var item in list)
{
//...
}
}
// Рендер, тут можно напрямую воспользоваться графическим API или добавить команду в CommandBuffer.
public void Render(Camera camera, GizmosList<SomeGizmo> list, CommandBuffer cb)
{
foreach (var item in list)
{
//...
}
}
}
}