Files
qbz/crates/vendor/i-slint-renderer-femtovg-1.16.1/wgpu.rs
T
vicrodh 5fc1beb869 fix(slint): vendor femtovg-wgpu renderer for transparent window surface
Slint 1.16's femtovg-wgpu renderer configures the wgpu surface via
get_default_config() and leaves the composite alpha mode at Auto, which
resolves to an opaque surface on KWin/Wayland — a borderless transparent
window then shows a black rectangular backing behind the rounded card.
WGPUConfiguration exposes no surface/alpha hook, so the only fix is a
renderer patch.

Vendor i-slint-renderer-femtovg-1.16.1 with a preferred_alpha_mode() that
picks a supported non-opaque mode (PreMultiplied / PostMultiplied /
Inherit, guarded by the surface's advertised alpha_modes, else Auto) and
wire it into set_surface(). Pulled in via [patch.crates-io]; Slint stays
pinned =1.16.1. The main window is unaffected (it paints opaque).

cx
2026-06-17 18:35:03 -06:00

451 lines
16 KiB
Rust

// Copyright © SixtyFPS GmbH <info@slint.dev>
// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0
use std::{cell::RefCell, pin::Pin, rc::Rc};
use i_slint_core::platform::PlatformError;
use i_slint_core::renderer::RendererSealed;
use i_slint_core::{api::PhysicalSize as PhysicalWindowSize, graphics::RequestedGraphicsAPI};
use crate::{FemtoVGRenderer, GraphicsBackend, WindowSurface};
use wgpu_28 as wgpu;
fn preferred_alpha_mode(modes: &[wgpu::CompositeAlphaMode]) -> wgpu::CompositeAlphaMode {
[
wgpu::CompositeAlphaMode::PreMultiplied,
wgpu::CompositeAlphaMode::PostMultiplied,
wgpu::CompositeAlphaMode::Inherit,
]
.into_iter()
.find(|mode| modes.contains(mode))
.unwrap_or(wgpu::CompositeAlphaMode::Auto)
}
pub struct WGPUBackend {
instance: RefCell<Option<wgpu::Instance>>,
device: RefCell<Option<wgpu::Device>>,
queue: RefCell<Option<wgpu::Queue>>,
surface_config: RefCell<Option<wgpu::SurfaceConfiguration>>,
surface: RefCell<Option<wgpu::Surface<'static>>>,
}
pub struct WGPUWindowSurface {
surface_texture: wgpu::SurfaceTexture,
}
impl WindowSurface<femtovg::renderer::WGPURenderer> for WGPUWindowSurface {
fn render_output(&self) -> impl Into<femtovg::renderer::WGPURenderOutput> {
&self.surface_texture.texture
}
}
impl GraphicsBackend for WGPUBackend {
type Renderer = femtovg::renderer::WGPURenderer;
type WindowSurface = WGPUWindowSurface;
const NAME: &'static str = "WGPU";
fn new_suspended() -> Self {
Self {
instance: Default::default(),
device: Default::default(),
queue: Default::default(),
surface_config: Default::default(),
surface: Default::default(),
}
}
fn clear_graphics_context(&self) {
self.surface_config.borrow_mut().take();
self.surface.borrow_mut().take();
self.queue.borrow_mut().take();
self.device.borrow_mut().take();
}
fn begin_surface_rendering(
&self,
) -> Result<Self::WindowSurface, Box<dyn std::error::Error + Send + Sync>> {
let surface = self.surface.borrow();
let surface = surface.as_ref().unwrap();
let frame = match surface.get_current_texture() {
Ok(texture) => texture,
Err(wgpu::SurfaceError::Timeout) => surface.get_current_texture()?,
// Outdated or lost: re-configure and try again
Err(_) => {
let mut device = self.device.borrow_mut();
let device = device.as_mut().unwrap();
surface.configure(device, self.surface_config.borrow().as_ref().unwrap());
surface.get_current_texture()?
}
};
Ok(WGPUWindowSurface { surface_texture: frame })
}
fn submit_commands(&self, commands: <Self::Renderer as femtovg::Renderer>::CommandBuffer) {
self.queue.borrow().as_ref().unwrap().submit(commands);
}
fn present_surface(
&self,
surface: Self::WindowSurface,
) -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
surface.surface_texture.present();
Ok(())
}
#[cfg(feature = "unstable-wgpu-28")]
fn with_graphics_api<R>(
&self,
callback: impl FnOnce(Option<i_slint_core::api::GraphicsAPI<'_>>) -> R,
) -> Result<R, i_slint_core::platform::PlatformError> {
let instance = self.instance.borrow().clone();
let device = self.device.borrow().clone();
let queue = self.queue.borrow().clone();
if let (Some(instance), Some(device), Some(queue)) = (instance, device, queue) {
Ok(callback(Some(i_slint_core::graphics::create_graphics_api_wgpu_28(
instance, device, queue,
))))
} else {
Ok(callback(None))
}
}
#[cfg(not(feature = "unstable-wgpu-28"))]
fn with_graphics_api<R>(
&self,
callback: impl FnOnce(Option<i_slint_core::api::GraphicsAPI<'_>>) -> R,
) -> Result<R, i_slint_core::platform::PlatformError> {
Ok(callback(None))
}
fn resize(
&self,
width: std::num::NonZeroU32,
height: std::num::NonZeroU32,
) -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
// Try to get hold of the wgpu types, but if we receive the resize event while suspended, ignore it.
let mut surface_config = self.surface_config.borrow_mut();
let Some(surface_config) = surface_config.as_mut() else { return Ok(()) };
let mut device = self.device.borrow_mut();
let Some(device) = device.as_mut() else { return Ok(()) };
let mut surface = self.surface.borrow_mut();
let Some(surface) = surface.as_mut() else { return Ok(()) };
// Prefer FIFO modes over possible Mailbox setting for frame pacing and better energy efficiency.
surface_config.present_mode = wgpu::PresentMode::AutoVsync;
surface_config.width = width.get();
surface_config.height = height.get();
surface.configure(device, surface_config);
Ok(())
}
}
impl FemtoVGRenderer<WGPUBackend> {
pub fn set_surface(
&self,
surface_target: impl Into<i_slint_core::graphics::wgpu_28::SurfaceTarget>,
size: PhysicalWindowSize,
requested_graphics_api: Option<RequestedGraphicsAPI>,
) -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
let (instance, adapter, device, queue, surface) =
i_slint_core::graphics::wgpu_28::init_instance_adapter_device_queue_surface(
surface_target,
requested_graphics_api,
/* rendering artifacts :( */
wgpu::Backends::GL,
)?;
let mut surface_config =
surface.get_default_config(&adapter, size.width, size.height).unwrap();
let swapchain_capabilities = surface.get_capabilities(&adapter);
let swapchain_format = swapchain_capabilities
.formats
.iter()
.find(|f| {
matches!(f, wgpu::TextureFormat::Rgba8Unorm | wgpu::TextureFormat::Bgra8Unorm)
})
.copied()
.unwrap_or_else(|| swapchain_capabilities.formats[0]);
surface_config.format = swapchain_format;
surface_config.alpha_mode = preferred_alpha_mode(&swapchain_capabilities.alpha_modes);
i_slint_core::debug_log!(
"[qbz-slint] femtovg-wgpu surface alpha modes: {:?}; selected: {:?}",
swapchain_capabilities.alpha_modes,
surface_config.alpha_mode
);
surface.configure(&device, &surface_config);
*self.graphics_backend.instance.borrow_mut() = Some(instance.clone());
*self.graphics_backend.device.borrow_mut() = Some(device.clone());
*self.graphics_backend.queue.borrow_mut() = Some(queue.clone());
*self.graphics_backend.surface_config.borrow_mut() = Some(surface_config);
*self.graphics_backend.surface.borrow_mut() = Some(surface);
let wgpu_renderer = femtovg::renderer::WGPURenderer::new(device, queue);
let femtovg_canvas = femtovg::Canvas::new_with_text_context(
wgpu_renderer,
crate::font_cache::FONT_CACHE.with(|cache| cache.borrow().text_context.clone()),
)
.unwrap();
let canvas = Rc::new(RefCell::new(femtovg_canvas));
self.reset_canvas(canvas);
Ok(())
}
}
struct TextureWindowSurface {
render_output: femtovg::renderer::WGPURenderOutput,
}
impl WindowSurface<femtovg::renderer::WGPURenderer> for TextureWindowSurface {
fn render_output(&self) -> impl Into<femtovg::renderer::WGPURenderOutput> {
self.render_output.clone()
}
}
struct WgpuTextureBackend {
instance: wgpu::Instance,
device: wgpu::Device,
queue: wgpu::Queue,
render_output: RefCell<Option<femtovg::renderer::WGPURenderOutput>>,
}
impl GraphicsBackend for WgpuTextureBackend {
type Renderer = femtovg::renderer::WGPURenderer;
type WindowSurface = TextureWindowSurface;
const NAME: &'static str = "WGPU Texture";
fn new_suspended() -> Self {
panic!("Suspended backend not supported for WgpuTextureBackend (requires device/queue)");
}
fn clear_graphics_context(&self) {
// Nothing to clear here, we don't own the device/queue/texture
}
fn begin_surface_rendering(
&self,
) -> Result<Self::WindowSurface, Box<dyn std::error::Error + Send + Sync>> {
let render_output =
self.render_output.borrow().clone().ok_or("No texture set for rendering")?;
Ok(TextureWindowSurface { render_output })
}
fn submit_commands(&self, commands: <Self::Renderer as femtovg::Renderer>::CommandBuffer) {
self.queue.submit(commands);
}
fn present_surface(
&self,
_surface: Self::WindowSurface,
) -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
// No presentation needed - the caller owns the texture and handles presenting it
Ok(())
}
#[cfg(feature = "unstable-wgpu-28")]
fn with_graphics_api<R>(
&self,
callback: impl FnOnce(Option<i_slint_core::api::GraphicsAPI<'_>>) -> R,
) -> Result<R, i_slint_core::platform::PlatformError> {
Ok(callback(Some(i_slint_core::graphics::create_graphics_api_wgpu_28(
self.instance.clone(),
self.device.clone(),
self.queue.clone(),
))))
}
#[cfg(not(feature = "unstable-wgpu-28"))]
fn with_graphics_api<R>(
&self,
callback: impl FnOnce(Option<i_slint_core::api::GraphicsAPI<'_>>) -> R,
) -> Result<R, i_slint_core::platform::PlatformError> {
Ok(callback(None))
}
fn resize(
&self,
_width: std::num::NonZeroU32,
_height: std::num::NonZeroU32,
) -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
// No resize needed - texture size is determined by the texture passed to render_to_texture
Ok(())
}
}
/// Use the FemtoVG renderer with WGPU when implementing a custom Slint platform where you want the scene to be rendered
/// into a WGPU texture. The rendering is done using the [FemtoVG](https://github.com/femtovg/femtovg) library.
pub struct FemtoVGWGPURenderer(FemtoVGRenderer<WgpuTextureBackend>);
impl FemtoVGWGPURenderer {
/// Creates a new FemtoVGWGPURenderer.
///
/// The `instance`, `device` and `queue` are the WGPU resources used for rendering.
/// These are also provided to [`Window::set_rendering_notifier()`](i_slint_core::api::Window::set_rendering_notifier) callbacks via [`GraphicsAPI::WGPU28`](i_slint_core::api::GraphicsAPI::WGPU28).
pub fn new(
instance: wgpu::Instance,
device: wgpu::Device,
queue: wgpu::Queue,
) -> Result<Self, PlatformError> {
let backend = WgpuTextureBackend {
instance,
device: device.clone(),
queue: queue.clone(),
render_output: RefCell::new(None),
};
let renderer = FemtoVGRenderer::new_internal(backend);
let wgpu_renderer = femtovg::renderer::WGPURenderer::new(device, queue);
let femtovg_canvas = femtovg::Canvas::new_with_text_context(
wgpu_renderer,
crate::font_cache::FONT_CACHE.with(|cache| cache.borrow().text_context.clone()),
)
.map_err(|e| format!("Failed to create femtovg canvas: {:?}", e))?;
let canvas = Rc::new(RefCell::new(femtovg_canvas));
renderer.reset_canvas(canvas);
Ok(Self(renderer))
}
/// Render the scene to the given texture view, with the specified size and format.
pub fn render_to_texture_view(
&self,
texture_view: &wgpu::TextureView,
width: u32,
height: u32,
format: wgpu::TextureFormat,
) -> Result<(), PlatformError> {
*self.0.graphics_backend.render_output.borrow_mut() =
Some(femtovg::renderer::WGPURenderOutput {
view: texture_view.clone(),
width,
height,
format,
});
let result = self.0.render();
*self.0.graphics_backend.render_output.borrow_mut() = None;
result
}
/// Render the scene to the given texture.
/// This is a convenience method that creates a texture view for the entire texture and calls `render_to_texture_view`.
pub fn render_to_texture(&self, texture: &wgpu::Texture) -> Result<(), PlatformError> {
let size = texture.size();
self.render_to_texture_view(
&texture.create_view(&wgpu::TextureViewDescriptor::default()),
size.width,
size.height,
texture.format(),
)
}
}
#[doc(hidden)]
impl RendererSealed for FemtoVGWGPURenderer {
fn text_size(
&self,
text_item: Pin<&dyn i_slint_core::item_rendering::RenderString>,
item_rc: &i_slint_core::items::ItemRc,
max_width: Option<i_slint_core::lengths::LogicalLength>,
text_wrap: i_slint_core::items::TextWrap,
) -> i_slint_core::lengths::LogicalSize {
self.0.text_size(text_item, item_rc, max_width, text_wrap)
}
fn char_size(
&self,
text_item: Pin<&dyn i_slint_core::item_rendering::HasFont>,
item_rc: &i_slint_core::items::ItemRc,
ch: char,
) -> i_slint_core::lengths::LogicalSize {
self.0.char_size(text_item, item_rc, ch)
}
fn font_metrics(
&self,
font_request: i_slint_core::graphics::FontRequest,
) -> i_slint_core::items::FontMetrics {
self.0.font_metrics(font_request)
}
fn text_input_byte_offset_for_position(
&self,
text_input: Pin<&i_slint_core::items::TextInput>,
item_rc: &i_slint_core::items::ItemRc,
pos: i_slint_core::lengths::LogicalPoint,
) -> usize {
self.0.text_input_byte_offset_for_position(text_input, item_rc, pos)
}
fn text_input_cursor_rect_for_byte_offset(
&self,
text_input: Pin<&i_slint_core::items::TextInput>,
item_rc: &i_slint_core::items::ItemRc,
byte_offset: usize,
) -> i_slint_core::lengths::LogicalRect {
self.0.text_input_cursor_rect_for_byte_offset(text_input, item_rc, byte_offset)
}
fn register_font_from_memory(
&self,
data: &'static [u8],
) -> Result<(), Box<dyn std::error::Error>> {
self.0.register_font_from_memory(data)
}
fn register_font_from_path(
&self,
path: &std::path::Path,
) -> Result<(), Box<dyn std::error::Error>> {
self.0.register_font_from_path(path)
}
fn default_font_size(&self) -> i_slint_core::lengths::LogicalLength {
self.0.default_font_size()
}
fn set_rendering_notifier(
&self,
callback: Box<dyn i_slint_core::api::RenderingNotifier>,
) -> Result<(), i_slint_core::api::SetRenderingNotifierError> {
self.0.set_rendering_notifier(callback)
}
fn free_graphics_resources(
&self,
component: i_slint_core::item_tree::ItemTreeRef,
items: &mut dyn Iterator<Item = Pin<i_slint_core::items::ItemRef<'_>>>,
) -> Result<(), PlatformError> {
self.0.free_graphics_resources(component, items)
}
fn set_window_adapter(&self, window_adapter: &Rc<dyn i_slint_core::window::WindowAdapter>) {
self.0.set_window_adapter(window_adapter)
}
fn window_adapter(&self) -> Option<Rc<dyn i_slint_core::window::WindowAdapter>> {
RendererSealed::window_adapter(&self.0)
}
fn resize(&self, size: i_slint_core::api::PhysicalSize) -> Result<(), PlatformError> {
self.0.resize(size)
}
fn take_snapshot(
&self,
) -> Result<
i_slint_core::graphics::SharedPixelBuffer<i_slint_core::graphics::Rgba8Pixel>,
PlatformError,
> {
self.0.take_snapshot()
}
fn supports_transformations(&self) -> bool {
self.0.supports_transformations()
}
}