Struct Vertices 

pub struct Vertices { /* private fields */ }

A mesh of triangles in user space, with optional texture coordinates.

Texture coordinates run from zero to one across the image and are read per vertex, which is the point of supplying them: every other way of drawing an image here maps it by position, and a mesh that wanted that mapping would not need coordinates at all.

Implementations

impl Vertices

pub fn new(mode: VertexMode, positions: Vec<Vec2>) -> Result<Vertices, Error>

A mesh from positions alone, filled by the paint.

The paint is sampled by position, as it is for any shape: a gradient runs across the mesh the way it would across a path covering the same area.

pub fn textured( mode: VertexMode, positions: Vec<Vec2>, texture_coords: Vec<Vec2>, ) -> Result<Vertices, Error>

A mesh whose vertices name where in the paint they read.

Any shader reads there, which is what dart:ui means by a color source at a mesh’s coordinates: an image samples its texture, a gradient measures its ramp, and a caller’s program receives them as uv beside the clip position and chooses. This used to say “requires an image paint”, which was true of neither the last two.

pub fn colored( mode: VertexMode, positions: Vec<Vec2>, colors: Vec<Color>, ) -> Result<Vertices, Error>

A mesh whose vertices each carry a color.

The color multiplies whatever the paint produced, so a white paint leaves the mesh’s own colors, and a gradient paint is shaded by them. Multiplying is the only combination offered: dart:ui takes a blend mode here, and every other mode either discards one of the two inputs or is not expressible without a second value per fragment.

pub fn indexed( mode: VertexMode, positions: Vec<Vec2>, texture_coords: Vec<Vec2>, indices: Vec<u32>, ) -> Result<Vertices, Error>

The same, with the triangles named by index rather than by order.

pub fn full( mode: VertexMode, positions: Vec<Vec2>, texture_coords: Vec<Vec2>, colors: Vec<Color>, indices: Vec<u32>, ) -> Result<Vertices, Error>

Everything at once, for a caller who has all of it.

pub fn positions(&self) -> &[Vec2]

pub fn texture_coords(&self) -> &[Vec2]

Texture coordinates, or empty where the mesh carries none.

pub fn colors(&self) -> &[Color]

Per-vertex colors, or empty where the mesh carries none.

pub fn indices(&self) -> &[u32]

Triangle indices, three per triangle, whatever mode built them.

pub fn is_empty(&self) -> bool

Trait Implementations

impl Clone for Vertices

fn clone(&self) -> Vertices

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Vertices

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

Formats the value using the given formatter.

impl Default for Vertices

fn default() -> Vertices

Returns the “default value” for a type.

impl PartialEq for Vertices

fn eq(&self, other: &Vertices) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Vertices