Struct QuadRenderer 

pub struct QuadRenderer { /* private fields */ }

Fast batched quad renderer using GPU instancing.

Optimized for bar charts with large datasets. Key features:

• Quads stored in data coordinates
• GPU transforms data → screen (pan/zoom is cheap)
• Only rebuild instance buffer when data actually changes

Implementations

impl QuadRenderer

pub fn new(context: Arc<GraphicsContext>, target_format: TextureFormat) -> Self

Create a new quad renderer with the given target texture format.

The target_format must match the render target this renderer will draw into. For window surfaces, use the format from WindowContext::format().

pub fn clear(&mut self)

Clear all quads. Call this when data changes.

pub fn add_quad(&mut self, min: Vec2, max: Vec2, color: Color)

Add a quad.

pub fn add_bar( &mut self, x_center: f32, width: f32, y_bottom: f32, y_top: f32, color: Color, )

Add a bar from center x, width, y range.

pub fn add(&mut self, quad: Quad)

Add a quad.

pub fn quad_count(&self) -> usize

Get the number of quads.

pub fn prepare(&mut self)

Prepare GPU buffers. Only uploads data if it changed.

pub fn render(&self, pass: &mut RenderPass<'_>, viewport: Viewport)

Render quads with identity transform (data coords = screen coords).

pub fn render_transformed( &self, pass: &mut RenderPass<'_>, transform: &DataTransform, )

Render quads with a DataTransform.

This is the preferred method for rendering with data-to-screen mapping. The transform is cheap to update (32 bytes), so pan/zoom only updates the transform, not the quad data.

Example

let transform = DataTransform::from_data_range(viewport, DataRangeParams {
    plot_x: 80.0, plot_y: 20.0,
    plot_width: 600.0, plot_height: 400.0,
    data_x_min: 0.0, data_x_max: 100.0,
    data_y_min: 0.0, data_y_max: 50.0,
});
quad_renderer.render_transformed(pass, &transform);

pub fn render_with_data_transform( &self, pass: &mut RenderPass<'_>, viewport: Viewport, plot_x: f32, plot_y: f32, plot_width: f32, plot_height: f32, data_x_min: f64, data_x_max: f64, data_y_min: f64, data_y_max: f64, )

Render quads with a data-to-screen transformation.

Deprecated: Use render_transformed with a DataTransform instead for a cleaner API.

This is the fast path for charts: data doesn’t change on pan/zoom, only the transform does.

Trait Implementations

impl RenderCapability for QuadRenderer

fn requirements() -> GpuRequirements

GPU requirements (features + limits) for this component.

fn name() -> &'static str

Human-readable name for diagnostics.