Struct SurfaceRenderTarget 

pub struct SurfaceRenderTarget { /* private fields */ }

Vello render target that writes to a surface in memory: a layer.

A scene is rendered into the pixels of the surface in whatever rendering mode draws it; a layer that stays on the GPU is part of the GPU modes (design document, stages 7 and 8).

Implementations

impl SurfaceRenderTarget

pub fn new(create_info: SurfaceRenderTargetCreateInfo) -> Self

Creates a surface render target. A surface is at least one pixel in each direction.

Panics

Panics when the surface is larger than a scene can be.

pub fn properties(&self) -> RenderTargetProperties

The properties of this render target.

pub fn has_render_context_affinity(&self) -> bool

Whether the render target lives on a GPU context and can only be used with it. Never the case for pixels in memory.

impl SurfaceRenderTarget

pub fn has_content(&self) -> bool

Whether a scene was rendered into the surface.

pub fn create_drawing_context_with( &self, disposables: Vec<Box<dyn FnOnce()>>, ) -> DrawingContextImpl

Creates a drawing context that draws into the surface. disposables run in order when the context is disposed, after the scene was rendered into the pixels.

Trait Implementations

impl IBitmapImpl for SurfaceRenderTarget

fn dpi(&self) -> Vector

The dots per inch (DPI) of the image.

fn pixel_size(&self) -> PixelSize

The size of the bitmap, in device pixels.

fn version(&self) -> i32

Version of the pixel data: incremented whenever the content changes.

fn save( &self, stream: &mut dyn Write, options: &BitmapEncoderOptions, ) -> Result<()>

Saves the bitmap to a stream, encoded as selected by options.

fn dispose(&self)

Releases the bitmap’s resources.

fn as_any(&self) -> &dyn Any

Lets the backend recover its concrete type.

fn as_readable_bitmap(&self) -> Option<&dyn IReadableBitmapImpl>

The bitmap viewed as IReadableBitmapImpl, when its pixels can be read.

impl IDrawableBitmapImpl for SurfaceRenderTarget

fn image(&self) -> Option<ImageData>

The current pixels of the bitmap as an image of premultiplied RGBA pixels, or None once the bitmap is disposed. The image is kept until the pixels change: drawing a bitmap again copies nothing.

impl IDrawingContextLayerImpl for SurfaceRenderTarget

fn blit(&self, context: &mut dyn IDrawingContextImpl)

Does optimized blit with source OVER overlay mode.

fn can_blit(&self) -> bool

Whether the layer can be blitted with blit.

fn is_corrupted(&self) -> bool

Whether the layer’s contents have been lost.

fn create_shared_snapshot(&self) -> Arc<SharedBitmapImpl>

The contents of the layer as a bitmap that can leave the render thread. A layer itself stays on the thread that created it.

fn create_drawing_context(&self) -> Box<dyn IDrawingContextImpl>

Creates a drawing context that draws into the layer.

fn as_layer_with_render_context_affinity( &self, ) -> Option<&dyn IDrawingContextLayerWithRenderContextAffinityImpl>

The layer as one that may be bound to the render context it was created with, if it is one.