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    /// How many presentable images the surface hands out
19    /// ([`crate::AcquiredSurfaceTexture::images`]).
20    pub images: u32,
21}
22
23pub trait DynSurface: DynResource {
24    unsafe fn configure(
25        &self,
26        device: &dyn DynDevice,
27        config: &SurfaceConfiguration,
28    ) -> Result<(), SurfaceError>;
29
30    unsafe fn unconfigure(&self, device: &dyn DynDevice);
31
32    unsafe fn acquire_texture(
33        &self,
34        timeout: Option<Duration>,
35        fence: &dyn DynFence,
36    ) -> Result<DynAcquiredSurfaceTexture, SurfaceError>;
37
38    unsafe fn discard_texture(&self, texture: Box<dyn DynSurfaceTexture>);
39}
40
41impl<S: Surface + DynResource> DynSurface for S {
42    unsafe fn configure(
43        &self,
44        device: &dyn DynDevice,
45        config: &SurfaceConfiguration,
46    ) -> Result<(), SurfaceError> {
47        let device = device.expect_downcast_ref();
48        unsafe { S::configure(self, device, config) }
49    }
50
51    unsafe fn unconfigure(&self, device: &dyn DynDevice) {
52        let device = device.expect_downcast_ref();
53        unsafe { S::unconfigure(self, device) }
54    }
55
56    unsafe fn acquire_texture(
57        &self,
58        timeout: Option<Duration>,
59        fence: &dyn DynFence,
60    ) -> Result<DynAcquiredSurfaceTexture, SurfaceError> {
61        let fence = fence.expect_downcast_ref();
62        unsafe { S::acquire_texture(self, timeout, fence) }.map(|ast| {
63            let texture = Box::new(ast.texture);
64            let suboptimal = ast.suboptimal;
65            DynAcquiredSurfaceTexture {
66                texture,
67                suboptimal,
68                images: ast.images,
69            }
70        })
71    }
72
73    unsafe fn discard_texture(&self, texture: Box<dyn DynSurfaceTexture>) {
74        unsafe { S::discard_texture(self, texture.unbox()) }
75    }
76}