Struct SvgItem 

pub struct SvgItem(Transformed<Node<VItem>, DAffine3>);

An Svg Item.

Its inner is a Node tree of VItems that mirrors the group structure of the source SVG: every usvg group becomes a group node carrying its relative transform (never baked into point data), and every path becomes a leaf holding its raw geometry. The root node’s transform carries the whole placement, so repositioning an SvgItem is O(1) and never rewrites points.

Use Vec::<VItem>::from to flatten into baked items, and SvgItem::by_id to address subtrees by their SVG element id.

Tuple Fields

0: Transformed<Node<VItem>, DAffine3>

Implementations

impl SvgItem

pub fn new(svg: impl AsRef<str>) -> Self

Creates a new SvgItem from a SVG string

The tree is centered on its own bounding box and flipped over the x axis (SVG’s y-down coordinates become y-up), matching the composition of the old move_to(ZERO) + rotate_on_x(PI) pipeline — but as an O(1) root pose instead of baked points.

pub fn from_tree(tree: &Tree) -> Self

Build the hierarchy from a usvg tree, preserving its structure.

Unlike SvgItem::new, no root normalization happens: coordinates stay in the SVG’s local (y-down) space. This keeps vitems_from_tree behaving exactly like its pre-hierarchy counterpart.

pub fn tree(&self) -> &Transformed<Node<VItem>, DAffine3>

The underlying hierarchy tree, including its root placement.

pub fn tree_mut(&mut self) -> &mut Transformed<Node<VItem>, DAffine3>

The underlying hierarchy tree, mutably.

pub fn into_tree(self) -> Transformed<Node<VItem>, DAffine3>

Consume the item, returning the underlying placed hierarchy tree.

pub fn by_id(&self, id: &str) -> Option<&VItem>

The leaf payload of the first node (depth-first) whose id matches, or — when the id sits on a group — the first leaf of that subtree.

SVG ids may be set on groups, so such lookups resolve to the group’s first leaf; use SvgItem::tree for structural access.

pub fn by_id_mut(&mut self, id: &str) -> Option<&mut VItem>

Mutable variant of SvgItem::by_id. Mutation reaches only the matched leaf’s local (canonical) data; node transforms are unaffected.

Trait Implementations

impl Aabb for SvgItem

fn aabb(&self) -> [DVec3; 2]

Get the Axis-aligned bounding box represent in [<min>, <max>].

fn aabb_size(&self) -> DVec3

Get the size of the Aabb.

fn aabb_center(&self) -> DVec3

Get the center of the Aabb.

impl<G: Into<DAffine3>> ApplyTransform<G> for SvgItem

fn apply(&mut self, transform: G) -> &mut Self

Bake transform (expressed in world coordinates) into the item’s data, in place.

impl Clone for SvgItem

fn clone(&self) -> SvgItem

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SvgItem

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Extract for SvgItem

type Target = CoreItem

Extraction target.

fn extract_into(&self, buf: &mut Vec<Self::Target>)

Append extracted values to buf.

fn extract(&self) -> Vec<Self::Target>

Extract into a newly allocated vector.

impl FillColor for SvgItem

fn fill_color(&self) -> AlphaColor<Srgb>

Getting fill color of an item

fn set_fill_color(&mut self, color: AlphaColor<Srgb>) -> &mut Self

Setting fill color(rgba) of an item

fn set_fill_opacity(&mut self, opacity: f32) -> &mut Self

Setting fill opacity of an item

impl From<SvgItem> for Vec<VItem>

fn from(value: SvgItem) -> Self

Flatten the hierarchy depth-first (painter’s-algorithm order), baking each leaf’s accumulated world affine into a clone of its VItem.

impl Opacity for SvgItem

fn set_opacity(&mut self, opacity: f32) -> &mut Self

Setting opacity of an item

impl StrokeColor for SvgItem

fn stroke_color(&self) -> AlphaColor<Srgb>

Getting stroke color of an item

fn set_stroke_color(&mut self, color: AlphaColor<Srgb>) -> &mut Self

Setting stroke color(rgba) of an item

fn set_stroke_opacity(&mut self, opacity: f32) -> &mut Self

Setting stroke opacity of an item

impl StrokeWidth for SvgItem

fn stroke_width(&self) -> f32

Get the stroke width

fn apply_stroke_func( &mut self, f: impl for<'a> Fn(&'a mut [Width]), ) -> &mut Self

Applying stroke width function to an item

fn set_stroke_width(&mut self, width: f32) -> &mut Self

Setting stroke width of an item