Skip to main content

wgpu_hal/dynamic/
surface.rs

1use alloc::boxed::Box;
2use core::time::Duration;
3
4use crate::{
5    DynDevice, DynFence, DynResource, DynSurfaceTexture, Surface, SurfaceConfiguration,
6    SurfaceError,
7};
8
9use super::DynResourceExt as _;
10
11#[derive(Debug)]
12pub struct DynAcquiredSurfaceTexture {
13    pub texture: Box<dyn DynSurfaceTexture>,
14    /// The presentation configuration no longer matches
15    /// the surface properties exactly, but can still be used to present
16    /// to the surface successfully.
17    pub suboptimal: bool,
18}
19
20pub trait DynSurface: DynResource {
21    /// Dynamic version of [Surface::configure]
22    unsafe fn configure(
23        &self,
24        device: &dyn DynDevice,
25        config: &SurfaceConfiguration,
26    ) -> Result<(), SurfaceError>;
27
28    /// Dynamic version of [Surface::unconfigure]
29    unsafe fn unconfigure(&self, device: &dyn DynDevice);
30
31    /// Dynamic version of [Surface::acquire_texture]
32    unsafe fn acquire_texture(
33        &self,
34        timeout: Option<Duration>,
35        fence: &dyn DynFence,
36    ) -> Result<DynAcquiredSurfaceTexture, SurfaceError>;
37
38    /// Dynamic version of [Surface::discard_texture]
39    unsafe fn discard_texture(&self, texture: Box<dyn DynSurfaceTexture>);
40}
41
42impl<S: Surface + DynResource> DynSurface for S {
43    unsafe fn configure(
44        &self,
45        device: &dyn DynDevice,
46        config: &SurfaceConfiguration,
47    ) -> Result<(), SurfaceError> {
48        let device = device.expect_downcast_ref();
49        unsafe { S::configure(self, device, config) }
50    }
51
52    unsafe fn unconfigure(&self, device: &dyn DynDevice) {
53        let device = device.expect_downcast_ref();
54        unsafe { S::unconfigure(self, device) }
55    }
56
57    unsafe fn acquire_texture(
58        &self,
59        timeout: Option<Duration>,
60        fence: &dyn DynFence,
61    ) -> Result<DynAcquiredSurfaceTexture, SurfaceError> {
62        let fence = fence.expect_downcast_ref();
63        unsafe { S::acquire_texture(self, timeout, fence) }.map(|ast| {
64            let texture = Box::new(ast.texture);
65            let suboptimal = ast.suboptimal;
66            DynAcquiredSurfaceTexture {
67                texture,
68                suboptimal,
69            }
70        })
71    }
72
73    unsafe fn discard_texture(&self, texture: Box<dyn DynSurfaceTexture>) {
74        unsafe { S::discard_texture(self, texture.unbox()) }
75    }
76}