Struct epaint::tessellator::Tessellator

source ·
pub struct Tessellator {
    pixels_per_point: f32,
    options: TessellationOptions,
    font_tex_size: [usize; 2],
    prepared_discs: Vec<PreparedDisc>,
    feathering: f32,
    clip_rect: Rect,
    scratchpad_points: Vec<Pos2>,
    scratchpad_path: Path,
}
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.

Fields§

§pixels_per_point: f32§options: TessellationOptions§font_tex_size: [usize; 2]§prepared_discs: Vec<PreparedDisc>§feathering: f32

size of feathering in points. normally the size of a physical pixel. 0.0 if disabled

§clip_rect: Rect

Only used for culling

§scratchpad_points: Vec<Pos2>§scratchpad_path: Path

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 crate::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 round_to_pixel_center(&self, point: f32) -> f32

source

pub fn round_pos_to_pixel(&self, pos: Pos2) -> Pos2

source

pub fn round_pos_to_pixel_center(&self, pos: Pos2) -> Pos2

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(&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: impl Into<PathStroke>, 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

fn tessellate_bezier_complete( &mut self, points: &[Pos2], fill: Color32, closed: bool, stroke: &PathStroke, out: &mut Mesh, )

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 crate::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.

source

fn add_clip_rects( &mut self, clipped_primitives: Vec<ClippedPrimitive>, ) -> Vec<ClippedPrimitive>

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> CloneToUninit for T
where T: Clone,

source§

unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. 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> ToOwned for T
where T: Clone,

source§

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>,

source§

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>,

source§

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.