Struct SoftBackend 

pub struct SoftBackend { /* private fields */ }

CPU framebuffer backend implementing oxiui_core::paint::RenderBackend.

Replays a oxiui_core::paint::DrawList onto a Framebuffer via a Canvas (clip-correct). All commands share one clip stack for the duration of the oxiui_core::paint::RenderBackend::execute call.

When the text feature is enabled, a cached oxiui_text::TextPipeline is held on the backend so that DrawText commands are fully shaped and rasterised rather than silently ignored.

Implementations

impl SoftBackend

pub fn new(width: u32, height: u32) -> Self

Create a backend with a transparent framebuffer.

pub fn with_background(width: u32, height: u32, bg: Color) -> Self

Create a backend pre-filled with a solid background colour.

pub fn set_quality(&mut self, quality: SoftRenderQuality)

Set the quality preset, influencing AA mode and shadow strategy.

pub fn quality(&self) -> &SoftRenderQuality

Return the current quality preset.

pub fn frame(&self) -> &Framebuffer

Borrow the underlying framebuffer.

pub fn into_framebuffer(self) -> Framebuffer

Consume the backend, returning the underlying framebuffer.

pub fn clear(&mut self, color: Color)

Fill the entire framebuffer with color.

pub fn width(&self) -> u32

Return the framebuffer width in pixels.

pub fn height(&self) -> u32

Return the framebuffer height in pixels.

pub fn to_bytes(&self, format: PixelFormat) -> Vec<u8>

Export the framebuffer as a flat byte vector in the requested pixel format.

The native internal format is 0xAARRGGBB (one u32 per pixel). This method reinterprets and reorders channels for the target format.

Format	Bytes/pixel	Channel order
Argb32	4	A, R, G, B
Bgra8	4	B, G, R, A
Rgb565	2	5R·6G·5B, big-endian

impl SoftBackend

pub fn with_quality(width: u32, height: u32, quality: SoftRenderQuality) -> Self

Create a backend pre-configured with a SoftRenderQuality preset.

The quality is stored and used to drive AA mode selection during subsequent execute calls.

AaMode::Supersampling / AaMode::Msaa4x enables the vertical- supersample coverage path in the scanline polygon rasterizer. AaMode::None disables AA (faster, aliased edges).

ShadowQuality::Off skips Gaussian convolution for box-shadow commands. ShadowQuality::Low and ShadowQuality::High use the existing GaussianCache with a small or full kernel radius respectively.

Trait Implementations

impl RenderBackend for SoftBackend

fn surface_size(&self) -> Size

Return the target surface dimensions in physical pixels.

fn supports_blur(&self) -> bool

Return true if this backend can render blur effects (e.g. box shadows).

fn supports_gradients(&self) -> bool

Return true if this backend can render gradient fills.

fn supports_paths(&self) -> bool

Return true if this backend can render arbitrary vector paths.

fn supports_images(&self) -> bool

Return true if this backend can blit ImageData.

fn supports_text(&self) -> bool

Return true if this backend can render text via DrawCommand::DrawText.

fn execute(&mut self, list: &DrawList) -> Result<(), UiError>

Replay an entire DrawList onto the backend’s surface.

fn supports_blend_modes(&self) -> bool

Return true if this backend honours DrawCommand::SetBlendMode commands (non-Normal blend modes).

fn supports_backdrop_blur(&self) -> bool

Return true if this backend can apply a backdrop blur via DrawCommand::BackdropBlur.