Struct PointRenderer 

pub struct PointRenderer { /* private fields */ }

Fast batched point renderer using GPU instancing.

Optimized for scatter charts with large datasets. Key features:

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

Implementations

impl PointRenderer

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

Create a new point 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 points. Call this when data changes.

pub fn add_point(&mut self, position: Vec2, size: f32, color: Color)

Add a point.

pub fn add(&mut self, point: Point)

Add a point.

pub fn point_count(&self) -> usize

Get the number of points.

pub fn prepare(&mut self)

Prepare GPU buffers. Only uploads data if it changed.

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

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

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

Render points 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 point 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,
});
point_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 points 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 PointRenderer

fn requirements() -> GpuRequirements

GPU requirements (features + limits) for this component.

fn name() -> &'static str

Human-readable name for diagnostics.