dioxuscut-rasterizer 0.1.3

Native CPU/GPU rasterizer for browser-free Dioxuscut frame rendering
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

//! Rasterizer backend trait and frame configuration.

use crate::scene::Scene;
use image::RgbaImage;
use thiserror::Error;

/// Error type for rasterization failures.
#[derive(Error, Debug)]
pub enum RasterError {
    #[error("Backend initialization failed: {0}")]
    Init(String),
    #[error("Failed to render frame {frame}: {reason}")]
    Frame { frame: u32, reason: String },
    #[error("Image encode error: {0}")]
    ImageEncode(String),
    #[error("Image asset error for {path}: {reason}")]
    ImageAsset { path: String, reason: String },
    #[error("Media asset error for {path}: {reason}")]
    MediaAsset { path: String, reason: String },
    #[error("Font asset error for {path}: {reason}")]
    FontAsset { path: String, reason: String },
    #[error("Scene compositing error: {0}")]
    Scene(String),
    #[error("Render cancelled")]
    Cancelled,
    #[error("Render timed out")]
    Timeout,
    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),
}

/// Per-frame rendering configuration.
#[derive(Debug, Clone)]
pub struct FrameConfig {
    pub width: u32,
    pub height: u32,
    pub frame: u32,
    pub fps: f64,
}

impl FrameConfig {
    pub fn new(width: u32, height: u32, frame: u32, fps: f64) -> Self {
        Self {
            width,
            height,
            frame,
            fps,
        }
    }

    /// Current playback time in seconds.
    pub fn time_secs(&self) -> f64 {
        self.frame as f64 / self.fps
    }
}

/// Trait implemented by every rasterizer backend.
pub trait RasterizerBackend: Send + Sync {
    /// Render a single `Scene` into an `RgbaImage`.
    fn render_frame(&self, scene: &Scene, config: &FrameConfig) -> Result<RgbaImage, RasterError>;
}