Shape Drawer
A libGDX library for drawing simple shapes using a Batch, eliminating the need to flush between Batch#begin() and Batch#end().
What is Shape Drawer?
Shape Drawer is a library for the libGDX game development framework that enables drawing simple shapes like lines, rectangles, and polygons using a Batch. It solves the performance issue of needing to flush the Batch when switching between ShapeRenderer and Batch rendering, allowing shapes to be drawn seamlessly within standard Batch drawing calls.
libGDX developers and game programmers who need efficient, integrated shape rendering within their 2D game or application without disrupting Batch performance.
Developers choose Shape Drawer because it eliminates the need to flush the Batch when drawing shapes, offering better performance and simpler code integration compared to libGDX's ShapeRenderer, especially when using PolygonBatch for filled shapes.
Overview
A library for libGDX that draws simple shapes using a batch.
Use Cases
Best For
- Drawing debug shapes or UI elements in libGDX games without performance hits
- Integrating shape rendering seamlessly with sprite batching in 2D games
- Creating geometric visuals like lines, circles, and polygons in libGDX applications
- Optimizing filled shape rendering with PolygonSpriteBatch in libGDX
- Adding simple vector-like graphics to libGDX projects without external tools
- Replacing libGDX's ShapeRenderer for more efficient batch-compatible drawing
Not Ideal For
- Projects requiring 3D graphics or complex vector shapes beyond basic 2D primitives
- Developers using immediate-mode ShapeRenderer for quick debugging without Batch integration
- Applications with rendering pipelines that don't involve libGDX's Batch system
- Games needing textured or shader-driven shapes without custom extensions
Pros & Cons
Pros
Draws shapes between Batch begin and end calls without flushing, improving performance by avoiding costly context switches, as emphasized in the README.
Supports lines, paths, ellipses, regular polygons, and rectangles with overloaded methods, providing flexibility for common 2D graphics needs.
Optimized for filled shapes when using PolygonBatch like PolygonSpriteBatch, enhancing rendering speed compared to non-PolygonBatch alternatives.
Only requires a Batch and a TextureRegion (e.g., a single white pixel) for setup, making it easy to integrate into existing libGDX projects.
Cons
Requires a TextureRegion for drawing, adding overhead if the project doesn't already use textures or atlases, as noted in the setup instructions.
Only handles simple 2D shapes, lacking support for complex or animated vector graphics, which may necessitate additional libraries or custom code.
Less efficient for filled shapes when using SpriteBatch instead of PolygonBatch, as the README admits, leading to potential performance trade-offs.
Frequently Asked Questions
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.