Struct RenderContext

pub struct RenderContext { /* private fields */ }

A render context.

Implementations

impl RenderContext

pub fn new(width: u16, height: u16) -> Self

Create a new render context with the given width and height in pixels.

pub fn fill_path(&mut self, path: &BezPath)

Fill a path.

pub fn stroke_path(&mut self, path: &BezPath)

Stroke a path.

pub fn fill_rect(&mut self, rect: &Rect)

Fill a rectangle.

pub fn fill_blurred_rounded_rect( &mut self, rect: &Rect, radius: f32, std_dev: f32, )

Fill a blurred rectangle with the given radius and standard deviation.

Note that this only works properly if the current paint is set to a solid color. If not, it will fall back to using black as the fill color.

pub fn stroke_rect(&mut self, rect: &Rect)

Stroke a rectangle.

pub fn glyph_run(&mut self, font: &Font) -> GlyphRunBuilder<'_, Self>

Creates a builder for drawing a run of glyphs that have the same attributes.

pub fn push_layer( &mut self, clip_path: Option<&BezPath>, blend_mode: Option<BlendMode>, opacity: Option<f32>, mask: Option<Mask>, )

Push a new layer with the given properties.

Note that the mask, if provided, needs to have the same size as the render context. Otherwise, it will be ignored. In addition to that, the mask will not be affected by the current transformation matrix in place.

pub fn push_clip_layer(&mut self, path: &BezPath)

Push a new clip layer.

pub fn push_blend_layer(&mut self, blend_mode: BlendMode)

Push a new blend layer.

pub fn push_opacity_layer(&mut self, opacity: f32)

Push a new opacity layer.

pub fn push_mask_layer(&mut self, mask: Mask)

Push a new mask layer.

Note that the mask, if provided, needs to have the same size as the render context. Otherwise, it will be ignored. In addition to that, the mask will not be affected by the current transformation matrix in place.

pub fn pop_layer(&mut self)

Pop the last-pushed layer.

pub fn set_stroke(&mut self, stroke: Stroke)

Set the current stroke.

pub fn set_paint(&mut self, paint: impl Into<PaintType>)

Set the current paint.

pub fn set_paint_transform(&mut self, paint_transform: Affine)

Set the current paint transform.

The paint transform is applied to the paint after the transform of the geometry the paint is drawn in, i.e., the paint transform is applied after the global transform. This allows transforming the paint independently from the drawn geometry.

pub fn reset_paint_transform(&mut self)

Reset the current paint transform.

pub fn set_fill_rule(&mut self, fill_rule: Fill)

Set the current fill rule.

pub fn set_transform(&mut self, transform: Affine)

Set the current transform.

pub fn reset_transform(&mut self)

Reset the current transform.

pub fn reset(&mut self)

Reset the render context.

pub fn render_to_buffer( &self, buffer: &mut [u8], width: u16, height: u16, render_mode: RenderMode, )

Render the current context into a buffer. The buffer is expected to be in premultiplied RGBA8 format with length width * height * 4

pub fn render_to_pixmap(&self, pixmap: &mut Pixmap, render_mode: RenderMode)

Render the current context into a pixmap.

pub fn width(&self) -> u16

Return the width of the pixmap.

pub fn height(&self) -> u16

Return the height of the pixmap.

Trait Implementations

impl ColrRenderer for RenderContext

fn push_clip_layer(&mut self, clip: &BezPath)

Push a new clip layer.

fn push_blend_layer(&mut self, blend_mode: BlendMode)

Push a new blend layer.

fn fill_solid(&mut self, color: AlphaColor<Srgb>)

Fill the current area with the given solid color.

fn fill_gradient(&mut self, gradient: Gradient)

Fill the current area with the given gradient color.

fn set_paint_transform(&mut self, affine: Affine)

Set the transform for paints.

fn pop_layer(&mut self)

Pop the last clip/blend layer.

impl Debug for RenderContext

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

Formats the value using the given formatter.

impl GlyphRenderer for RenderContext

fn fill_glyph(&mut self, prepared_glyph: PreparedGlyph<'_>)

Fill glyphs with the current paint and fill rule.

fn stroke_glyph(&mut self, prepared_glyph: PreparedGlyph<'_>)

Stroke glyphs with the current paint and stroke settings.