Struct piet_cairo::CairoRenderContext

pub struct CairoRenderContext<'a> { /* fields omitted */ }

Implementations

impl<'a> CairoRenderContext<'a>

pub fn new(ctx: &Context) -> CairoRenderContext<'_>

Create a new Cairo back-end.

At the moment, it uses the “toy text API” for text layout, but when we change to a more sophisticated text layout approach, we’ll probably need a factory for that as an additional argument.

Trait Implementations

impl<'a> IntoBrush<CairoRenderContext<'a>> for Brush

fn make_brush<'b>(
    &'b self,
    _piet: &mut CairoRenderContext<'_>,
    _bbox: impl FnOnce() -> Rect
) -> Cow<'b, Brush>

impl<'a> RenderContext for CairoRenderContext<'a>

type Brush = Brush

The type of a “brush”.

type Text = CairoText

An associated factory for creating text layouts and related resources.

type TextLayout = CairoTextLayout

The type use to represent text layout objects.

type Image = CairoImage

The associated type of an image.

fn status(&mut self) -> Result<(), Error>

Report an internal error.

fn clear(&mut self, region: impl Into<Option<Rect>>, color: Color)

Replace a region of the canvas with the provided Color.

fn solid_brush(&mut self, color: Color) -> Brush

Create a new brush resource.

fn gradient(
    &mut self,
    gradient: impl Into<FixedGradient>
) -> Result<Brush, Error>

Create a new gradient brush.

fn fill(&mut self, shape: impl Shape, brush: &impl IntoBrush<Self>)

Fill a [Shape], using the non-zero fill rule.

fn fill_even_odd(&mut self, shape: impl Shape, brush: &impl IntoBrush<Self>)

Fill a shape, using the even-odd fill rule.

fn clip(&mut self, shape: impl Shape)

Clip to a [Shape].

fn stroke(
    &mut self,
    shape: impl Shape,
    brush: &impl IntoBrush<Self>,
    width: f64
)

Stroke a [Shape], using the default StrokeStyle.

fn stroke_styled(
    &mut self,
    shape: impl Shape,
    brush: &impl IntoBrush<Self>,
    width: f64,
    style: &StrokeStyle
)

Stroke a [Shape], providing a custom StrokeStyle.

fn text(&mut self) -> &mut Self::Text

Returns a reference to a shared Text object.

fn draw_text(&mut self, layout: &Self::TextLayout, pos: impl Into<Point>)

Draw a TextLayout.

fn save(&mut self) -> Result<(), Error>

Save the context state.

fn restore(&mut self) -> Result<(), Error>

Restore the context state.

fn finish(&mut self) -> Result<(), Error>

Finish any pending operations.

fn transform(&mut self, transform: Affine)

Apply a transform.

fn current_transform(&self) -> Affine

Returns the transformations currently applied to the context.

fn make_image(
    &mut self,
    width: usize,
    height: usize,
    buf: &[u8],
    format: ImageFormat
) -> Result<Self::Image, Error>

Create a new Image from a pixel buffer.

fn draw_image(
    &mut self,
    image: &Self::Image,
    dst_rect: impl Into<Rect>,
    interp: InterpolationMode
)

Draw an Image into the provided [Rect].

fn draw_image_area(
    &mut self,
    image: &Self::Image,
    src_rect: impl Into<Rect>,
    dst_rect: impl Into<Rect>,
    interp: InterpolationMode
)

Draw a specified area of an Image.

fn capture_image_area(
    &mut self,
    _src_rect: impl Into<Rect>
) -> Result<Self::Image, Error>

Create an Image of the specified region of the context.

fn blurred_rect(
    &mut self,
    rect: Rect,
    blur_radius: f64,
    brush: &impl IntoBrush<Self>
)

Draw a rectangle with Gaussian blur.

fn with_save(
    &mut self,
    f: impl FnOnce(&mut Self) -> Result<(), Error>
) -> Result<(), Error>

Do graphics operations with the context state saved and then restored.