Struct piet_common::CairoRenderContext

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

Methods

impl<'a> CairoRenderContext<'a>

pub fn new(ctx: &mut 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> RenderContext for CairoRenderContext<'a>

type Point = Vec2

Cairo mostly uses raw f64, so this is as convenient as anything.

type Coord = f64

The type of 1D measurements, for example stroke width.

type Brush = Brush

The type of a "brush".

type Text = CairoText

An associated factory for creating text layouts and related resources.

type TextLayout = CairoTextLayout

type Image = ImageSurface

The associated type of an image.

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

Report an internal error.

fn clear(&mut self, rgb: u32)

Clear the canvas with the given color.

fn solid_brush(&mut self, rgba: u32) -> Result<Brush, Error>

Create a new brush resource.

fn gradient(&mut self, gradient: Gradient) -> Result<Brush, Error>

Create a new gradient brush.

fn fill<impl Shape>(
    &mut self,
    shape: impl Shape,
    brush: &<CairoRenderContext<'a> as RenderContext>::Brush,
    fill_rule: FillRule
) where
    impl Shape: Shape, 

Fill a shape.

fn clip<impl Shape>(&mut self, shape: impl Shape, fill_rule: FillRule) where
    impl Shape: Shape, 

Clip to a shape.

fn stroke<impl Shape, impl RoundInto>(
    &mut self,
    shape: impl Shape,
    brush: &<CairoRenderContext<'a> as RenderContext>::Brush,
    width: impl RoundInto,
    style: Option<&StrokeStyle>
) where
    impl RoundInto: RoundInto<<CairoRenderContext<'a> as RenderContext>::Coord>,
    impl Shape: Shape, 

Stroke a shape.

fn text(&mut self) -> &mut <CairoRenderContext<'a> as RenderContext>::Text

fn draw_text<impl RoundInto>(
    &mut self,
    layout: &<CairoRenderContext<'a> as RenderContext>::TextLayout,
    pos: impl RoundInto,
    brush: &<CairoRenderContext<'a> as RenderContext>::Brush
) where
    impl RoundInto: RoundInto<<CairoRenderContext<'a> as RenderContext>::Point>, 

Draw a text layout.

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 make_image(
    &mut self,
    width: usize,
    height: usize,
    buf: &[u8],
    format: ImageFormat
) -> Result<<CairoRenderContext<'a> as RenderContext>::Image, Error>

Create a new image from a pixel buffer.

fn draw_image<impl Into>(
    &mut self,
    image: &<CairoRenderContext<'a> as RenderContext>::Image,
    rect: impl Into,
    interp: InterpolationMode
) where
    impl Into: Into<Rect>, 

Draw an image.

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

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