Struct PathStorage 

pub struct PathStorage { /* private fields */ }

Path storage — the main vertex container.

Stores an ordered sequence of vertices, each with an (x, y) coordinate and a path command. Supports multiple sub-paths separated by move_to or stop commands. Implements VertexSource for use in the rendering pipeline.

Port of C++ agg::path_storage (typedef for path_base<vertex_block_storage<double>>).

Implementations

impl PathStorage

pub fn new() -> Self

Create an empty path storage.

pub fn remove_all(&mut self)

Remove all vertices (keeps allocated memory).

pub fn free_all(&mut self)

Remove all vertices and free memory.

pub fn start_new_path(&mut self) -> usize

Begin a new sub-path. If the last command is not stop, inserts a stop command first. Returns the index where the new path will start.

pub fn add_vertex(&mut self, x: f64, y: f64, cmd: u32)

Add a vertex with an explicit command.

Port of C++ path_storage::add_vertex(x, y, cmd).

pub fn move_to(&mut self, x: f64, y: f64)

Add a move_to command.

pub fn move_rel(&mut self, dx: f64, dy: f64)

Add a relative move_to command.

pub fn line_to(&mut self, x: f64, y: f64)

Add a line_to command.

pub fn line_rel(&mut self, dx: f64, dy: f64)

Add a relative line_to command.

pub fn hline_to(&mut self, x: f64)

Add a horizontal line_to command.

pub fn hline_rel(&mut self, dx: f64)

Add a relative horizontal line_to command.

pub fn vline_to(&mut self, y: f64)

Add a vertical line_to command.

pub fn vline_rel(&mut self, dy: f64)

Add a relative vertical line_to command.

pub fn arc_to( &mut self, rx: f64, ry: f64, angle: f64, large_arc_flag: bool, sweep_flag: bool, x: f64, y: f64, )

Add an SVG-style arc_to command.

pub fn arc_rel( &mut self, rx: f64, ry: f64, angle: f64, large_arc_flag: bool, sweep_flag: bool, dx: f64, dy: f64, )

Add a relative SVG-style arc_to command.

pub fn curve3(&mut self, x_ctrl: f64, y_ctrl: f64, x_to: f64, y_to: f64)

Add a quadratic Bezier curve (curve3) with explicit control point.

pub fn curve3_rel(&mut self, dx_ctrl: f64, dy_ctrl: f64, dx_to: f64, dy_to: f64)

Add a relative quadratic Bezier curve with explicit control point.

pub fn curve3_smooth(&mut self, x_to: f64, y_to: f64)

Add a smooth quadratic Bezier curve (reflected control point).

pub fn curve3_smooth_rel(&mut self, dx_to: f64, dy_to: f64)

Add a relative smooth quadratic Bezier curve.

pub fn curve4( &mut self, x_ctrl1: f64, y_ctrl1: f64, x_ctrl2: f64, y_ctrl2: f64, x_to: f64, y_to: f64, )

Add a cubic Bezier curve (curve4) with two explicit control points.

pub fn curve4_rel( &mut self, dx_ctrl1: f64, dy_ctrl1: f64, dx_ctrl2: f64, dy_ctrl2: f64, dx_to: f64, dy_to: f64, )

Add a relative cubic Bezier curve with two explicit control points.

pub fn curve4_smooth( &mut self, x_ctrl2: f64, y_ctrl2: f64, x_to: f64, y_to: f64, )

Add a smooth cubic Bezier curve (reflected first control point).

pub fn curve4_smooth_rel( &mut self, dx_ctrl2: f64, dy_ctrl2: f64, dx_to: f64, dy_to: f64, )

Add a relative smooth cubic Bezier curve.

pub fn end_poly(&mut self, flags: u32)

Add an end_poly command with optional flags.

pub fn close_polygon(&mut self, flags: u32)

Close the current polygon.

pub fn total_vertices(&self) -> usize

Total number of vertices stored.

pub fn rel_to_abs(&self, x: &mut f64, y: &mut f64)

Convert relative coordinates to absolute by adding last vertex position.

pub fn last_vertex_xy(&self, x: &mut f64, y: &mut f64) -> u32

Get the last vertex’s (x, y) and command. Returns PATH_CMD_STOP if empty.

pub fn prev_vertex_xy(&self, x: &mut f64, y: &mut f64) -> u32

Get the second-to-last vertex’s (x, y) and command.

pub fn last_command(&self) -> u32

Get the last command (or PATH_CMD_STOP if empty).

pub fn last_x(&self) -> f64

Get the X coordinate of the last vertex (or 0.0 if empty).

pub fn last_y(&self) -> f64

Get the Y coordinate of the last vertex (or 0.0 if empty).

pub fn vertex_idx(&self, idx: usize, x: &mut f64, y: &mut f64) -> u32

Get a vertex by index. Returns the command.

pub fn command(&self, idx: usize) -> u32

Get a command by index.

pub fn modify_vertex(&mut self, idx: usize, x: f64, y: f64)

Modify a vertex’s coordinates.

pub fn modify_vertex_cmd(&mut self, idx: usize, x: f64, y: f64, cmd: u32)

Modify a vertex’s coordinates and command.

pub fn modify_command(&mut self, idx: usize, cmd: u32)

Modify only a vertex’s command.

pub fn swap_vertices(&mut self, v1: usize, v2: usize)

Swap two vertices (coordinates and commands).

pub fn concat_path(&mut self, vs: &mut dyn VertexSource, path_id: u32)

Concatenate all vertices from a vertex source as-is.

pub fn join_path(&mut self, vs: &mut dyn VertexSource, path_id: u32)

Join a vertex source to the existing path (pen stays down).

The first move_to of the joined path is converted to line_to if the current path already has a vertex endpoint.

pub fn concat_poly(&mut self, data: &[f64], closed: bool)

Concatenate a polygon from flat coordinate data.

pub fn join_poly(&mut self, data: &[f64], closed: bool)

Join a polygon from flat coordinate data.

pub fn invert_polygon(&mut self, start: usize)

Invert the polygon starting at start.

pub fn arrange_polygon_orientation( &mut self, start: usize, orientation: u32, ) -> usize

Arrange polygon orientation for a single polygon starting at start. Returns the index past the end of the polygon.

pub fn arrange_orientations(&mut self, start: usize, orientation: u32) -> usize

Arrange orientations of all polygons in a sub-path.

pub fn arrange_orientations_all_paths(&mut self, orientation: u32)

Arrange orientations of all polygons in all paths.

pub fn flip_x(&mut self, x1: f64, x2: f64)

Flip all vertices horizontally between x1 and x2.

pub fn flip_y(&mut self, y1: f64, y2: f64)

Flip all vertices vertically between y1 and y2.

pub fn translate(&mut self, dx: f64, dy: f64, path_id: usize)

Translate vertices starting from path_id until a stop command.

pub fn translate_all_paths(&mut self, dx: f64, dy: f64)

Translate all vertices in all paths.

pub fn transform<F: Fn(f64, f64) -> (f64, f64)>( &mut self, trans: &F, path_id: usize, )

Transform vertices starting from path_id using a closure.

pub fn transform_all_paths<F: Fn(f64, f64) -> (f64, f64)>(&mut self, trans: &F)

Transform all vertices in all paths using a closure.

pub fn align_path(&mut self, idx: usize) -> usize

Align a single path so that nearly-equal start/end points become exact. Returns the index past the end of this path.

pub fn align_all_paths(&mut self)

Align all paths.

Trait Implementations

impl Clone for PathStorage

fn clone(&self) -> PathStorage

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for PathStorage

fn default() -> Self

Returns the “default value” for a type.

impl VertexSource for PathStorage

fn rewind(&mut self, path_id: u32)

Reset the vertex source to the beginning of the given path. path_id selects which sub-path to iterate (0 for the first/only path).

fn vertex(&mut self, x: &mut f64, y: &mut f64) -> u32

Return the next vertex. Writes coordinates to x and y, returns a path command. Returns PATH_CMD_STOP when iteration is complete.