pub struct Tessellator { /* private fields */ }
Expand description

Converts Shapes into triangles (Mesh).

For performance reasons it is smart to reuse the same Tessellator.

See also tessellate_shapes, a convenient wrapper around Tessellator.

Implementations§

source§

impl Tessellator

source

pub fn new( pixels_per_point: f32, options: TessellationOptions, font_tex_size: [usize; 2], prepared_discs: Vec<PreparedDisc> ) -> Self

Create a new Tessellator.

  • pixels_per_point: number of physical pixels to each logical point
  • options: tessellation quality
  • shapes: what to tessellate
  • font_tex_size: size of the font texture. Required to normalize glyph uv rectangles when tessellating text.
  • prepared_discs: What TextureAtlas::prepared_discs returns. Can safely be set to an empty vec.
source

pub fn set_clip_rect(&mut self, clip_rect: Rect)

Set the Rect to use for culling.

source

pub fn round_to_pixel(&self, point: f32) -> f32

source

pub fn tessellate_clipped_shape( &mut self, clipped_shape: ClippedShape, out_primitives: &mut Vec<ClippedPrimitive> )

Tessellate a clipped shape into a list of primitives.

source

pub fn tessellate_shape(&mut self, shape: Shape, out: &mut Mesh)

Tessellate a single Shape into a Mesh.

This call can panic the given shape is of Shape::Vec or Shape::Callback. For that, use Self::tessellate_clipped_shape instead.

  • shape: the shape to tessellate.
  • out: triangles are appended to this.
source

pub fn tessellate_circle(&mut self, shape: CircleShape, out: &mut Mesh)

Tessellate a single CircleShape into a Mesh.

  • shape: the circle to tessellate.
  • out: triangles are appended to this.
source

pub fn tessellate_ellipse(&mut self, shape: EllipseShape, out: &mut Mesh)

Tessellate a single EllipseShape into a Mesh.

  • shape: the ellipse to tessellate.
  • out: triangles are appended to this.
source

pub fn tessellate_mesh(&mut self, mesh: &Mesh, out: &mut Mesh)

Tessellate a single Mesh into a Mesh.

  • mesh: the mesh to tessellate.
  • out: triangles are appended to this.
source

pub fn tessellate_line( &mut self, points: [Pos2; 2], stroke: Stroke, out: &mut Mesh )

Tessellate a line segment between the two points with the given stroke into a Mesh.

  • shape: the mesh to tessellate.
  • out: triangles are appended to this.
source

pub fn tessellate_path(&mut self, path_shape: &PathShape, out: &mut Mesh)

Tessellate a single PathShape into a Mesh.

  • path_shape: the path to tessellate.
  • out: triangles are appended to this.
source

pub fn tessellate_rect(&mut self, rect: &RectShape, out: &mut Mesh)

Tessellate a single Rect into a Mesh.

  • rect: the rectangle to tessellate.
  • out: triangles are appended to this.
source

pub fn tessellate_text(&mut self, text_shape: &TextShape, out: &mut Mesh)

Tessellate a single TextShape into a Mesh.

  • text_shape: the text to tessellate.
  • out: triangles are appended to this.
source

pub fn tessellate_quadratic_bezier( &mut self, quadratic_shape: QuadraticBezierShape, out: &mut Mesh )

Tessellate a single QuadraticBezierShape into a Mesh.

  • quadratic_shape: the shape to tessellate.
  • out: triangles are appended to this.
source

pub fn tessellate_cubic_bezier( &mut self, cubic_shape: CubicBezierShape, out: &mut Mesh )

Tessellate a single CubicBezierShape into a Mesh.

  • cubic_shape: the shape to tessellate.
  • out: triangles are appended to this.
source§

impl Tessellator

source

pub fn tessellate_shapes( &mut self, shapes: Vec<ClippedShape> ) -> Vec<ClippedPrimitive>

Turns Shape:s into sets of triangles.

The given shapes will tessellated in the same order as they are given. They will be batched together by clip rectangle.

  • pixels_per_point: number of physical pixels to each logical point
  • options: tessellation quality
  • shapes: what to tessellate
  • font_tex_size: size of the font texture. Required to normalize glyph uv rectangles when tessellating text.
  • prepared_discs: What TextureAtlas::prepared_discs returns. Can safely be set to an empty vec.

The implementation uses a Tessellator.

§Returns

A list of clip rectangles with matching Mesh.

Trait Implementations§

source§

impl Clone for Tessellator

source§

fn clone(&self) -> Tessellator

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> Pointable for T

source§

const ALIGN: usize = _

The alignment of pointer.
§

type Init = T

The type for initializers.
source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.