Struct LineRenderer 

pub struct LineRenderer { /* private fields */ }

Fast batched line renderer using GPU instancing.

Optimized for charts with large datasets. Key features:

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

Implementations

impl LineRenderer

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

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

pub fn add_line(&mut self, start: Vec2, end: Vec2, width: f32, color: Color)

Add a line segment.

pub fn add_segment(&mut self, segment: LineSegment)

Add a line segment.

pub fn segment_count(&self) -> usize

Get the number of line segments.

pub fn prepare(&mut self)

Prepare GPU buffers. Only uploads data if it changed.

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

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

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

Render lines 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 line 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,
});
line_renderer.render_transformed(pass, &transform);

Trait Implementations

impl RenderCapability for LineRenderer

fn requirements() -> GpuRequirements

GPU requirements (features + limits) for this component.

fn name() -> &'static str

Human-readable name for diagnostics.