Tracking issue: Amazing Gizmos

[nicopap]

This issue tracks the progress on Gizmo features

Contributing

Want to check off one of those checkboxes? Nothing easier!

1. Open a feature request you can copy/paste the description if you feel lazy!
2. Implement the feature and open a PR!

All related issues will be listed in this tracking issue.

The (IMO) easy ones

• Linecaps
• more gizmo shapes
• light source gizmos

All features

Not sorted in any specific order:

• Gizmos MVP Immediate Mode Line/Gizmo Drawing #6529 Make it possible to draw lines on screen, for them to be immediately despawned next frame
• AABB gizmos Add a bounding box gizmo #8468 Draw entity bounding boxes
• Light source gizmos: Gizmos that show where light sources are placed, potentially their intensity, color & direction (Add basic light gizmos #12228)
• UI layout gizmos: show outline of CSS flexbox and grid UI elements. Add a gizmo-based overlay to show UI node outlines (Adopted) #11237
• More than one gizmo kind: Gizmo line width/depth bias/render layer should be configurable at call site, not just in a resource (system level: Multiple Configurations for Gizmos #10342)
  • multiple line width
  • multiple depth bias
  • multiple render layers
• Retained gizmos: We want to give shape to invisible things such as physics collider. It would make more sense to have a retained API for this. Would supersede wireframe rendering Retained gizmos #9178
• FixedUpdate gizmos: Currently gizmos do not work if used in the FixedUpdate schedule. (Contextually clearing gizmos #10973, Make Gizmos compatible with FixedUpdate #9153)
• More gizmo shapes (Gizmos for primitive shapes #10571)
  • arrows (Gizmo Arrows #10550)
    • Double ended arrows (Add double end arrow to gizmos #11890)
  • lines/linestrip/ray
  • cuboids/rectangles
  • spheres/circles
  • ellipses
  • Regular polygons
  • arcs/ semi-circles
  • grids (Add Grid gizmos #11988)
  • 3d Grid
  • splines
  • camera
  • 3D meshes/2D meshes/wireframes (Mesh rendering support for Gizmos #10621)
  • axes (Add coordinate axes gizmo #12211)
  • light bulb (Add basic light gizmos #12228)
  • rounded cuboid (Add Rounded box gizmos #11948)
  • Cylinder/arbitrary 3d shape extrusion
  • frustum (conical frustrum with 4 segments)
  • pyramid/cone (Cone with 4/N segments)
  • capsule
  • triangle
  • tetrahedron
  • torus/donuts
  • Rounded arbitrary shapes
• Gizmo registry: Allows plugin to register categories of gizmos and defer to user ability to toggle or control properties of gizmos within a category. See Better Gizmo API #9187 and Multiple Configurations for Gizmos #10342
  • System-level gizmo registration: Automate the gizmo registration by inheriting a system-level registry assignation
• Actually-immediate-mode API: no SystemParam required, just a macro/function call to draw gizmos, nothing more. No more need to modify the system signature to add gizmos, or even pass around the gizmo struct, in the style of https://github.com/nicopap/bevy-debug-text-overlay/)
• dotted lines: Gizmo with a dotted line effect.
• Line caps: Gizmo squares have ugly corners because the line caps are not filled. See The tutorial that led to bevy_polyline
  • Square caps: Extend the gizmo lines by the line width
  • Round caps: Add a semi-circle of line-width radius to the end of lines
• Line Joints: Smooth out space between subsequent lines (Gizmo line joints #12252)
  • Round joints
  • flat joints
  • spiky joints
• Text gizmos: Draw text on screen without the bevy_text sanctimonious rituals. Just a gizmo_print!("foobar") and it would show on screen.
  • multiline text: Should support line returns
  • user-provided font
  • Text in 2d space: Gizmo should let print text on screen on arbitrary positions in 2D games.
  • log-style text: Users would not provide a position, but it would show up on screen as event in a way similar to a console message in Garry's Mod or Minecraft. Note: This is already implemented as a 3rd party plugin in https://github.com/nicopap/bevy-debug-text-overlay/
  • Text in 3d space: Gizmo should let print text in 3D games, may chose to keep the same size with distance or apply perspective.
  • Oriented text: Text that always faces a specific direction.
  • Non-overlapping text: There could be a toggle that allows text placed on screen through 2D or 3D API to not overlap, even if they should, given their provided position.
• Filled shape gizmos: We want to be able to draw filled shapes, this might be useful for special signaling or highlighting areas. See https://github.com/james-j-obrien/bevy_vector_shapes
  • semitransparent filled shape gizmos: Semi-transparent this becomes apparently much more useful.
• Reactive gizmos: ability to associate Gizmos to game state; accept input from gizmos and modify game state from gizmos. It probably would look like an immediate mode UI, but 3D Modular, Reactive Gizmos #9498

[brandon-reinhart]

I'm now using gizmos extensively for debug visualizations.

Here's a +1 for filled shapes. One of my gizmos is visualizing a quadtree, another is the nav mesh (using the quadtree) and filled gizmos would let me make an Unreal-style navigable area preview. It works now, just not as easy to look at as it could be.

[dmyyy]

#9475 also seems relevant.

[musjj]

Could you also add regular and irregular polygons to the list of shapes?

[nicopap]

Could you also add regular and irregular polygons to the list of shapes?

I think it could be better expressed as "2D meshes". I'll reword the post to be more inclusive.

[SIGSTACKFAULT]

Text in 3d space: Gizmo should let print text in 3D games, may chose to keep the same size with distance or apply perspective.

Should have the choice between the text being billboarded or facing a specific direction

[SIGSTACKFAULT]

Could write a polyhedron function with a similar interface to OpenSCAD's polyhedron() function. And by being less strict about the faces argument (since we only actually care about edges) it would work for polygons too.

[SIGSTACKFAULT]

Under arrows, could you add "double-ended"? thought of it just now but i'll forget by the time i can do it

[nicopap]

I think passing a Mesh to the gizmos would be enough for the polyhedron API (it's listed in the issue as "3D Mesh")

Under arrows, could you add "double-ended"? thought of it just now but i'll forget by the time i can do it

Should have the choice between the text being billboarded or facing a specific direction

Added them!

[SpecificProtagonist]

Could you add "Compatibility with FixedUpdate"?