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 vertices(&self) -> &[VertexD]

Immutable access to the raw vertex slice.

Useful when you need to iterate or cache path data without going through the mutable VertexSource iterator protocol. The slice is valid for the lifetime of the PathStorage.

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.