Struct MaskedRgb565Surface 

pub struct MaskedRgb565Surface<'a, R = IntegerRasterizer> { /* private fields */ }

A caller-owned RGB565 surface with one packed opacity bit per pixel.

The surface doubles as a TileRenderer for Shape display lists. Rendering clears only mask bits in damaged tiles; color words underneath transparent pixels are intentionally left unspecified.

Implementations

impl<'a> MaskedRgb565Surface<'a, IntegerRasterizer>

pub fn new( width: u32, height: u32, stride_pixels: usize, pixels: &'a mut [u16], mask_stride_bytes: usize, mask: &'a mut [u8], tile_size: TileSize, ) -> Result<Self, SurfaceError>

Creates a transparent surface using the built-in integer rasterizer.

impl<'a, R> MaskedRgb565Surface<'a, R>

pub fn with_rasterizer( width: u32, height: u32, stride_pixels: usize, pixels: &'a mut [u16], mask_stride_bytes: usize, mask: &'a mut [u8], tile_size: TileSize, rasterizer: R, ) -> Result<Self, SurfaceError>

Creates a transparent surface using an explicit shape rasterizer.

pub fn bitmap_view(&self) -> BitmapView<'_>

Borrows the retained pixels and mask as a transparent sprite resource.

pub const fn rasterizer(&self) -> &R

Returns the selected rasterization policy.

pub fn rasterizer_mut(&mut self) -> &mut R

Returns the selected rasterization policy mutably.

Trait Implementations

impl<R> TileRenderer<Shape, ()> for MaskedRgb565Surface<'_, R>

where R: TileRasterizer<Shape>,

type Error = SurfaceError

The backing renderer error.

fn viewport(&self) -> Bounds

Returns the stable viewport used for this render.

fn tile_size(&self) -> TileSize

Returns the damage tile dimensions.

fn object_coverage( &self, object: Instance<'_, Shape>, tile: Bounds, (): &(), ) -> TileCoverage

Classifies the pixels this backend would produce for object in tile.

fn object_change( &self, old: Instance<'_, Shape>, new: Instance<'_, Shape>, tile: Bounds, (): &(), ) -> TileChange

Returns the proof status behind the old/new change decision.

fn begin_tile(&mut self, tile: Bounds) -> Result<(), Self::Error>

Selects the active tile.

fn clear_tile(&mut self) -> Result<(), Self::Error>

Clears the active tile to the renderer’s background color.

fn draw_item( &mut self, object: Instance<'_, Shape>, (): &(), ) -> Result<(), Self::Error>

Draws an object after applying its transform, clipped to the active tile.

fn flush_tile<'b>( &'b mut self, ) -> impl Future<Output = Result<(), Self::Error>> + 'b

where Shape: 'b,

Flushes the active tile to the backing display.

fn preflight<const N: usize>( &mut self, _frame: FrameView<'_, I, N>, _resources: &R, ) -> Result<(), Self::Error>

Resolves resources and optionally prepares the frame before display writes.

fn object_may_change( &self, old: Instance<'_, I>, new: Instance<'_, I>, tile: Bounds, resources: &R, ) -> bool

Returns whether replacing old with new may change this backend’s tile-local output.

fn prefers_clear_before_full(&self) -> bool

Returns whether this backend prefers a clear even when a proven TileCoverage::Full item will immediately initialize the whole tile.

fn finish_frame<'a>( &'a mut self, ) -> impl Future<Output = Result<(), Self::Error>> + 'a

where I: 'a, R: 'a,

Completes any tile transfers still owned by the backend.