🥮 mooncakes.io
    Sign in

    moui_skia_renderer

    Native Skia renderer provider for MoUI

    moui
    renderer
    skia
    gui
    Download zip
    Author
    Version
    0.2.1
    License
    Apache-2.0
    Repository
    Last updated
    5 days ago
    Downloads
    189

    Dependencies

    #MoUI Skia Renderer

    Native Skia renderer provider for wzzc-dev/moui.

    NativePlatformSurface

    source
    pub(open) trait NativePlatformSurface {
      fn surface_route(Self) -> SkiaSurfaceRoute
      fn gpu_promoted(Self) -> Bool
      fn platform_label(Self) -> String
    }

    SkiaRendererError

    source
    pub(all) suberror SkiaRendererError {
      SkiaUnavailable
      SurfaceUnavailable
      CanvasUnavailable
      ReadPixelsUnavailable
      GpuContextUnavailable(String)
      PresentFailed(String)
    } derive(Eq, ToJson, 
    Debug    )

    SkiaRendererError::equal

    source

    SkiaRendererError::message

    source
    fn SkiaRendererError::message(self : SkiaRendererError) -> String

    SkiaRendererError::not_equal

    source
    fn SkiaRendererError::not_equal(x : SkiaRendererError, y : SkiaRendererError) -> Bool

    SkiaRendererError::to_json

    source

    SkiaRendererError::to_repr

    source

    HostGpuPresentOutcome

    source
    pub(all) struct HostGpuPresentOutcome {
      // private fields
    }

    Outcome of a HostGpuPresentTarget::present_gpu call.

    • succeeded: whether the platform presented the drawable successfully.
    • next_surface: Some(surface) to swap the renderer's surface for the next frame (per-drawable GPU backends); None to keep the current surface (long-lived GPU backends).

    HostGpuPresentOutcome::new

    source

    HostGpuPresentOutcome::next_surface

    source

    HostGpuPresentOutcome::succeeded

    source
    fn HostGpuPresentOutcome::succeeded(self : HostGpuPresentOutcome) -> Bool

    HostGpuPresentTarget

    source
    pub struct HostGpuPresentTarget {
      // private fields
    }

    Present target for the direct host-GPU-surface route. The presenter takes a flushed @skia_native.Surface and lets the platform present its underlying drawable (Metal CAMetalDrawable, VkSwapchainKHR image, EGLSurface backbuffer, or D3D12 swapchain backbuffer). No SkiaPixelFrame, no Bytes, no CGImage/UIImage/NSImage/Bitmap/PixelMap intermediate.

    HostGpuPresentTarget is a sibling of SkiaPresentTarget; both are accepted by create_with_present_target_and_route. A renderer is bound to exactly one of them. When gpu_target = Some(_), target_kind() returns HostGpuSurface and the render loop bypasses read_frame.

    create_window_surface is invoked lazily immediately before the first render, after the native event loop can provide a drawable, and again on each resize after attachment. It receives the GpuContext the renderer created internally (via create_gpu_context) and the current surface metrics, and returns a window-backed Surface (e.g. one wrapping a Metal CAMetalDrawable's MTLTexture). When it returns None, the renderer raises SurfaceUnavailable. The constructor's offscreen GPU surface is a typed placeholder only; no commands are recorded into it, so the first rendered frame still goes directly to the host drawable with no readback.

    present_gpu is invoked each frame after flush_and_submit. It receives the same GpuContext and the flushed Surface. It returns the optional Surface to use for the next frame. GPU backends whose Skia Surface is bound to a per-frame drawable (Metal CAMetalDrawable, Vulkan swapchain image) return a fresh Surface; backends that reuse the same Surface (e.g. a long-lived EGLSurface/D3D12 swapchain backbuffer wrapped via SkSurfaces::WrapBackendSurface) return None to keep the current one. Returning Some(surface) causes the renderer to swap self.surface to the returned value before the next frame.

    HostGpuPresentTarget::description

    source
    fn HostGpuPresentTarget::description(self : HostGpuPresentTarget) -> String

    HostGpuPresentTarget::new

    source

    NativeGpuPlatform

    source
    pub(all) enum NativeGpuPlatform {
      MacOS
      Windows
      Linux
      Android
      IOS
      HarmonyOS
    } derive(Eq, ToJson, 
    Debug    )

    NativeGpuPlatform::equal

    source

    NativeGpuPlatform::gpu_promoted

    source
    fn NativeGpuPlatform::gpu_promoted(_self : NativeGpuPlatform) -> Bool

    NativeGpuPlatform::not_equal

    source
    fn NativeGpuPlatform::not_equal(x : NativeGpuPlatform, y : NativeGpuPlatform) -> Bool

    NativeGpuPlatform::platform_label

    source
    fn NativeGpuPlatform::platform_label(self : NativeGpuPlatform) -> String

    NativeGpuPlatform::surface_route

    source

    NativeGpuPlatform::to_json

    source

    NativeGpuPlatform::to_repr

    source

    NativeRendererMode

    source
    pub(all) enum NativeRendererMode {
      Auto
      SkiaGpu
      SkiaRaster
    } derive(Eq, ToJson, 
    Debug    )

    NativeRendererMode::equal

    source

    NativeRendererMode::label

    source
    fn NativeRendererMode::label(self : NativeRendererMode) -> String

    NativeRendererMode::not_equal

    source

    NativeRendererMode::parse

    source
    fn NativeRendererMode::parse(value : String) -> NativeRendererMode?

    NativeRendererMode::to_json

    source

    NativeRendererMode::to_repr

    source

    SkiaEmojiFontFallbackDiagnostic

    source
    pub struct SkiaEmojiFontFallbackDiagnostic {
      // private fields
    } derive(Eq, ToJson, 
    Debug    )

    SkiaEmojiFontFallbackDiagnostic::cluster_count

    source

    SkiaEmojiFontFallbackDiagnostic::deterministic_color_emoji_ready

    source
    fn SkiaEmojiFontFallbackDiagnostic::deterministic_color_emoji_ready(self : SkiaEmojiFontFallbackDiagnostic) -> Bool

    SkiaEmojiFontFallbackDiagnostic::emoji_fallback_attempted

    source
    fn SkiaEmojiFontFallbackDiagnostic::emoji_fallback_attempted(self : SkiaEmojiFontFallbackDiagnostic) -> Bool

    SkiaEmojiFontFallbackDiagnostic::emoji_hint

    source

    SkiaEmojiFontFallbackDiagnostic::equal

    source

    SkiaEmojiFontFallbackDiagnostic::fallback_character

    source

    SkiaEmojiFontFallbackDiagnostic::fallback_language_tag_count

    source
    fn SkiaEmojiFontFallbackDiagnostic::fallback_language_tag_count(self : SkiaEmojiFontFallbackDiagnostic) -> Int

    SkiaEmojiFontFallbackDiagnostic::fallback_language_tags

    source
    fn SkiaEmojiFontFallbackDiagnostic::fallback_language_tags(self : SkiaEmojiFontFallbackDiagnostic) -> Array[String]

    SkiaEmojiFontFallbackDiagnostic::fallback_request_language_count

    source
    fn SkiaEmojiFontFallbackDiagnostic::fallback_request_language_count(self : SkiaEmojiFontFallbackDiagnostic) -> Int

    SkiaEmojiFontFallbackDiagnostic::fallback_request_ready

    source
    fn SkiaEmojiFontFallbackDiagnostic::fallback_request_ready(self : SkiaEmojiFontFallbackDiagnostic) -> Bool

    SkiaEmojiFontFallbackDiagnostic::fallback_script_tag

    source
    fn SkiaEmojiFontFallbackDiagnostic::fallback_script_tag(self : SkiaEmojiFontFallbackDiagnostic) -> String

    SkiaEmojiFontFallbackDiagnostic::font_family

    source

    SkiaEmojiFontFallbackDiagnostic::font_source

    source

    SkiaEmojiFontFallbackDiagnostic::glyph_count

    source

    SkiaEmojiFontFallbackDiagnostic::glyph_format

    source

    SkiaEmojiFontFallbackDiagnostic::glyph_height

    source

    SkiaEmojiFontFallbackDiagnostic::glyph_key

    source

    SkiaEmojiFontFallbackDiagnostic::glyph_width

    source

    SkiaEmojiFontFallbackDiagnostic::missing_glyph_recovery_ready

    source
    fn SkiaEmojiFontFallbackDiagnostic::missing_glyph_recovery_ready(self : SkiaEmojiFontFallbackDiagnostic) -> Bool

    SkiaEmojiFontFallbackDiagnostic::not_equal

    source

    SkiaEmojiFontFallbackDiagnostic::resolved_font_name

    source
    fn SkiaEmojiFontFallbackDiagnostic::resolved_font_name(self : SkiaEmojiFontFallbackDiagnostic) -> String

    SkiaEmojiFontFallbackDiagnostic::resolved_missing_glyph_count

    source
    fn SkiaEmojiFontFallbackDiagnostic::resolved_missing_glyph_count(self : SkiaEmojiFontFallbackDiagnostic) -> Int

    SkiaEmojiFontFallbackDiagnostic::shaper

    source

    SkiaEmojiFontFallbackDiagnostic::text

    source

    SkiaEmojiFontFallbackDiagnostic::text_system_id

    source

    SkiaEmojiFontFallbackDiagnostic::to_json

    source

    SkiaEmojiFontFallbackDiagnostic::to_repr

    source

    SkiaFontResolution

    source
    pub(all) enum SkiaFontResolution {
      SystemFontMgr
      EmptyTypeface
    } derive(Eq, ToJson, 
    Debug    )

    SkiaFontResolution::equal

    source

    SkiaFontResolution::not_equal

    source

    SkiaFontResolution::to_json

    source

    SkiaFontResolution::to_repr

    source

    SkiaHybridRenderer

    source
    pub struct SkiaHybridRenderer {
      // private fields
    }

    A renderer owner that keeps the raster factory and GPU queue model under one lifecycle. Recorded queue completions are internal handoff signals; only the window-backed presenter can produce a public Presented completion.

    SkiaHybridRenderer::drain_present_completions

    source

    SkiaHybridRenderer::fallback_to_raster

    source
    fn SkiaHybridRenderer::fallback_to_raster(self : SkiaHybridRenderer) -> Bool

    SkiaHybridRenderer::render_frame

    source

    SkiaHybridRenderer::requested_mode

    source

    SkiaHybridRenderer::surface_route

    source

    SkiaPixelFrame

    source
    pub struct SkiaPixelFrame {
      // private fields
    } derive(Eq, 
    Debug    )

    SkiaPixelFrame::equal

    source

    SkiaPixelFrame::height

    source
    fn SkiaPixelFrame::height(self : SkiaPixelFrame) -> Int

    SkiaPixelFrame::not_equal

    source
    fn SkiaPixelFrame::not_equal(x : SkiaPixelFrame, y : SkiaPixelFrame) -> Bool

    SkiaPixelFrame::pixels

    source
    fn SkiaPixelFrame::pixels(self : SkiaPixelFrame) -> Bytes

    SkiaPixelFrame::row_bytes

    source
    fn SkiaPixelFrame::row_bytes(self : SkiaPixelFrame) -> Int

    SkiaPixelFrame::scale_factor

    source
    fn SkiaPixelFrame::scale_factor(self : SkiaPixelFrame) -> Double

    SkiaPixelFrame::to_repr

    source

    SkiaPixelFrame::width

    source
    fn SkiaPixelFrame::width(self : SkiaPixelFrame) -> Int

    SkiaPresentKind

    source
    pub(all) enum SkiaPresentKind {
      CpuPixelFrame
      HostGpuSurface
    } derive(Eq, ToJson, 
    Debug    )

    Discriminator for which present path a SkiaRasterRenderer is wired to.

    • CpuPixelFrame: the renderer reads pixels back via Surface::read_pixels and hands a SkiaPixelFrame to the platform presenter. This is the only path wired today on every platform and remains the default/test fallback per ADR 0006.
    • HostGpuSurface: the renderer is bound to a HostGpuPresentTarget. The platform presenter owns a window-backed GPU surface (Metal drawable, Vulkan swapchain, EGL surface, D3D12 swapchain) and Skia flushes the drawable directly. read_pixels and the second CPU copy are skipped.

    SkiaPresentKind::equal

    source

    SkiaPresentKind::not_equal

    source
    fn SkiaPresentKind::not_equal(x : SkiaPresentKind, y : SkiaPresentKind) -> Bool

    SkiaPresentKind::to_json

    source

    SkiaPresentKind::to_repr

    source

    SkiaPresentTarget

    source
    pub struct SkiaPresentTarget {
      // private fields
    }

    SkiaPresentTarget::new

    source
    fn SkiaPresentTarget::new(description~ : String, present~ : (SkiaPixelFrame) -> Bool) -> SkiaPresentTarget

    SkiaRasterRenderer

    source
    pub struct SkiaRasterRenderer {
      // private fields
    }

    SkiaRasterRenderer::apply_image_resource_load_completion

    source

    SkiaRasterRenderer::backend_info

    source

    SkiaRasterRenderer::backend_kind

    source

    SkiaRasterRenderer::dispose

    source
    fn SkiaRasterRenderer::dispose(self : SkiaRasterRenderer) -> Unit

    SkiaRasterRenderer::draw_platform_view_pixels

    source
    fn SkiaRasterRenderer::draw_platform_view_pixels(self : SkiaRasterRenderer, pixels : Bytes, src_width : Int, src_height : Int, src_stride : Int, dst_x : Double, dst_y : Double, dst_width : Double, dst_height : Double) -> Unit

    This should be called after render_frame but before the window system presents

    SkiaRasterRenderer::gpu_target

    source

    Returns the bound HostGpuPresentTarget when the renderer is on the direct GPU present path. Returns None for the legacy CPU pixel-frame route.

    SkiaRasterRenderer::image_resources

    source

    SkiaRasterRenderer::last_frame

    source

    SkiaRasterRenderer::metrics

    source

    SkiaRasterRenderer::present_count

    source
    fn SkiaRasterRenderer::present_count(self : SkiaRasterRenderer) -> Int

    SkiaRasterRenderer::record_frame_picture

    source

    Record a frame into an immutable picture for replay by a native renderer worker. No MoonBit object crosses the thread boundary.

    SkiaRasterRenderer::render

    source

    SkiaRasterRenderer::render_frame

    source

    SkiaRasterRenderer::resize

    source

    SkiaRasterRenderer::set_platform_view_draw_fn

    source
    fn SkiaRasterRenderer::set_platform_view_draw_fn(self : SkiaRasterRenderer, draw_fn : () -> Unit?) -> Unit

    Set a callback to draw platform view pixels after command rendering but before flush.

    SkiaRasterRenderer::surface_diagnostic_summary

    source
    fn SkiaRasterRenderer::surface_diagnostic_summary(self : SkiaRasterRenderer) -> String

    SkiaRasterRenderer::surface_is_gpu

    source
    fn SkiaRasterRenderer::surface_is_gpu(self : SkiaRasterRenderer) -> Bool

    SkiaRasterRenderer::surface_route

    source

    SkiaRasterRenderer::target_kind

    source

    Returns which present path the renderer is bound to. CpuPixelFrame reads pixels back via Surface::read_pixels and hands a SkiaPixelFrame to the platform presenter; HostGpuSurface lets the platform present a window-backed GPU drawable directly with no CPU readback.

    SkiaRasterRenderer::text_system

    source

    SkiaRasterRenderer::to_renderer_session

    source

    Adapt a live Skia renderer to the renderer-neutral host lifecycle.

    SkiaRasterRenderer::unsupported_command_count

    source
    fn SkiaRasterRenderer::unsupported_command_count(self : SkiaRasterRenderer) -> Int

    SkiaRasterRenderer::unsupported_command_diagnostics

    source
    fn SkiaRasterRenderer::unsupported_command_diagnostics(self : SkiaRasterRenderer) -> Array[SkiaUnsupportedCommandDiagnostic]

    SkiaSurfaceRoute

    source
    pub(all) enum SkiaSurfaceRoute {
      RasterSurfaceRoute
      MetalGpuSurfaceRoute
      VulkanGpuSurfaceRoute
      EglGpuSurfaceRoute
      Direct3DGpuSurfaceRoute
    } derive(Eq, ToJson, 
    Debug    )

    Renderer-local route used to select the concrete Skia GPU API. Platform and graphics API names never cross the root moui/render boundary.

    SkiaSurfaceRoute::equal

    source

    SkiaSurfaceRoute::is_gpu

    source
    fn SkiaSurfaceRoute::is_gpu(self : SkiaSurfaceRoute) -> Bool

    SkiaSurfaceRoute::is_implemented

    source
    fn SkiaSurfaceRoute::is_implemented(self : SkiaSurfaceRoute) -> Bool

    SkiaSurfaceRoute::label

    source
    fn SkiaSurfaceRoute::label(self : SkiaSurfaceRoute) -> String

    SkiaSurfaceRoute::not_equal

    source
    fn SkiaSurfaceRoute::not_equal(x : SkiaSurfaceRoute, y : SkiaSurfaceRoute) -> Bool

    SkiaSurfaceRoute::to_json

    source

    SkiaSurfaceRoute::to_repr

    source

    SkiaTextSelectionGeometryDiagnostic

    source
    pub struct SkiaTextSelectionGeometryDiagnostic {
      // private fields
    } derive(Eq, ToJson, 
    Debug    )

    SkiaTextSelectionGeometryDiagnostic::bidi_visual_order_observed

    source
    fn SkiaTextSelectionGeometryDiagnostic::bidi_visual_order_observed(self : SkiaTextSelectionGeometryDiagnostic) -> Bool

    SkiaTextSelectionGeometryDiagnostic::equal

    source

    SkiaTextSelectionGeometryDiagnostic::hit_test_inside

    source

    SkiaTextSelectionGeometryDiagnostic::hit_test_line_index

    source

    SkiaTextSelectionGeometryDiagnostic::hit_test_offset

    source

    SkiaTextSelectionGeometryDiagnostic::line_count

    source

    SkiaTextSelectionGeometryDiagnostic::not_equal

    source

    SkiaTextSelectionGeometryDiagnostic::selected_line_count

    source

    SkiaTextSelectionGeometryDiagnostic::selection_range

    source

    SkiaTextSelectionGeometryDiagnostic::selection_rect_count

    source

    SkiaTextSelectionGeometryDiagnostic::text

    source

    SkiaTextSelectionGeometryDiagnostic::to_json

    source

    SkiaTextSelectionGeometryDiagnostic::to_repr

    source

    SkiaTextSelectionGeometryDiagnostic::visual_order_differs

    source

    SkiaTextSelectionGeometryDiagnostic::visual_segment_count

    source

    SkiaTextVisualOrderDiagnostic

    source
    pub struct SkiaTextVisualOrderDiagnostic {
      // private fields
    } derive(Eq, ToJson, 
    Debug    )

    SkiaTextVisualOrderDiagnostic::equal

    source

    SkiaTextVisualOrderDiagnostic::glyph_count

    source

    SkiaTextVisualOrderDiagnostic::logical_cluster_count

    source
    fn SkiaTextVisualOrderDiagnostic::logical_cluster_count(self : SkiaTextVisualOrderDiagnostic) -> Int

    SkiaTextVisualOrderDiagnostic::logical_text

    source

    SkiaTextVisualOrderDiagnostic::not_equal

    source

    SkiaTextVisualOrderDiagnostic::segment_count

    source

    SkiaTextVisualOrderDiagnostic::to_json

    source

    SkiaTextVisualOrderDiagnostic::to_repr

    source

    SkiaTextVisualOrderDiagnostic::visual_cluster_count

    source
    fn SkiaTextVisualOrderDiagnostic::visual_cluster_count(self : SkiaTextVisualOrderDiagnostic) -> Int

    SkiaTextVisualOrderDiagnostic::visual_order_differs

    source
    fn SkiaTextVisualOrderDiagnostic::visual_order_differs(self : SkiaTextVisualOrderDiagnostic) -> Bool

    SkiaTextVisualOrderDiagnostic::visual_text

    source

    SkiaTextVisualOrderDiagnostic::width

    source

    SkiaUnsupportedCommandDiagnostic

    source
    pub struct SkiaUnsupportedCommandDiagnostic {
      // private fields
    } derive(Eq, ToJson, 
    Debug    )

    SkiaUnsupportedCommandDiagnostic::command

    source

    SkiaUnsupportedCommandDiagnostic::equal

    source

    SkiaUnsupportedCommandDiagnostic::not_equal

    source

    SkiaUnsupportedCommandDiagnostic::reason

    source

    SkiaUnsupportedCommandDiagnostic::to_json

    source

    SkiaUnsupportedCommandDiagnostic::to_repr

    source

    backend_info

    source

    create_hybrid_renderer

    source
    fn create_hybrid_renderer(platform : NativeGpuPlatform, requested : NativeRendererMode, metrics : 
    SurfaceMetrics    , target : SkiaPresentTarget, gpu_available~ : Bool, gpu_promoted~ : Bool, gpu_target? : HostGpuPresentTarget?, font_resolution? : SkiaFontResolution, async_image_loading? : Bool) -> SkiaHybridRenderer raise SkiaRendererError

    create_with_present_target

    source
    fn create_with_present_target(metrics : 
    SurfaceMetrics    , target : SkiaPresentTarget, font_resolution? : SkiaFontResolution, async_image_loading? : Bool) -> SkiaRasterRenderer raise SkiaRendererError

    create_with_present_target_and_route

    source
    fn create_with_present_target_and_route(metrics : 
    SurfaceMetrics    , target : SkiaPresentTarget, surface_route? : SkiaSurfaceRoute, gpu_target? : HostGpuPresentTarget?, font_resolution? : SkiaFontResolution, async_image_loading? : Bool) -> SkiaRasterRenderer raise SkiaRendererError

    from_env

    source

    Resolve the environment policy entirely inside the Skia renderer package.

    gpu

    source

    Build a Skia direct GPU provider. The platform policy belongs to this renderer module and interprets the opaque native handles after binding.

    raster

    source

    Build a Skia CPU raster provider from the renderer-neutral host contract.

    renderer_descriptor

    source

    resolve_surface_route

    source
    fn[P : NativePlatformSurface] resolve_surface_route(platform : P, requested : NativeRendererMode, gpu_available~ : Bool, gpu_promoted~ : Bool) -> SkiaSurfaceRoute

    skia_available

    source
    fn skia_available() -> Bool

    skia_emoji_font_fallback_diagnostic

    source
    fn skia_emoji_font_fallback_diagnostic(text? : String, font? : 
    FontSpec    , font_resolution? : SkiaFontResolution) -> SkiaEmojiFontFallbackDiagnostic?

    skia_gpu_metal_preflight_summary

    source
    fn skia_gpu_metal_preflight_summary() -> String

    skia_gpu_native_descriptor

    source

    skia_image_load_completion

    source

    skia_image_load_completion_from_bytes

    source
    fn skia_image_load_completion_from_bytes(source : String, bytes : Bytes, background_io? : Bool, background_decode? : Bool) -> 
    ImageResourceLoadCompletion

    skia_provider_capabilities

    source

    Skia owns the capability declarations used by both its raster and GPU providers. The backend enum is descriptive metadata; the id is the report identity used by composition roots.

    skia_raster_native_descriptor

    source

    skia_text_selection_geometry_diagnostic

    source
    fn skia_text_selection_geometry_diagnostic(text : String, selection? : 
    TextRange    ?, font? : 
    FontSpec    , max_width? : Double, font_resolution? : SkiaFontResolution) -> SkiaTextSelectionGeometryDiagnostic?

    skia_text_system

    source
    fn skia_text_system(resolution? : SkiaFontResolution) -> 
    TextSystem

    skia_text_visual_order_diagnostic

    source
    fn skia_text_visual_order_diagnostic(text : String, font? : 
    FontSpec    , font_resolution? : SkiaFontResolution) -> SkiaTextVisualOrderDiagnostic?

    Source Files

    Powered by MoonBit

    Site sourceReport issuePackagesBuild queueSkillsStatistics

    © 2026 mooncakes.io