Struct piet_coregraphics::CoreGraphicsContext

pub struct CoreGraphicsContext<'a> { /* private fields */ }

Implementations

impl<'a> CoreGraphicsContext<'a>

pub fn new_y_up(
    ctx: &mut CGContextRef,
    height: f64,
    text: Option<CoreGraphicsText>
) -> CoreGraphicsContext<'_>

Create a new context with the y-origin at the top-left corner.

This is not the default for CoreGraphics; but it is the defualt for piet. To map between the two coordinate spaces you must also pass an explicit height argument.

The optional text argument can be a reuseable CoreGraphicsText struct; a new one will be constructed if None is passed.

pub fn new_y_down(
    ctx: &mut CGContextRef,
    text: Option<CoreGraphicsText>
) -> CoreGraphicsContext<'_>

Create a new context with the y-origin at the bottom right corner.

This is the default for core graphics, but not for piet.

The optional text argument can be a reuseable CoreGraphicsText struct; a new one will be constructed if None is passed.

Trait Implementations

impl<'a> Drop for CoreGraphicsContext<'a>

fn drop(&mut self)

Executes the destructor for this type.

impl<'a> RenderContext for CoreGraphicsContext<'a>

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

Fill a shape.

type Brush = Brush

The type of a “brush”.

type Text = CoreGraphicsText

An associated factory for creating text layouts and related resources.

type TextLayout = CoreGraphicsTextLayout

The type use to represent text layout objects.

type Image = CoreGraphicsImage

The associated type of an image.

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_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 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,
    src_image: &Self::Image,
    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 current_transform(&self) -> Affine

Returns the transformations currently applied to the context.

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

Report an internal error.

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.

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