pub trait Surface<A: Api>: WasmNotSend + WasmNotSync {
// Required methods
unsafe fn configure(
&mut self,
device: &A::Device,
config: &SurfaceConfiguration
) -> Result<(), SurfaceError>;
unsafe fn unconfigure(&mut self, device: &A::Device);
unsafe fn acquire_texture(
&mut self,
timeout: Option<Duration>
) -> Result<Option<AcquiredSurfaceTexture<A>>, SurfaceError>;
unsafe fn discard_texture(&mut self, texture: A::SurfaceTexture);
}Required Methods§
sourceunsafe fn configure(
&mut self,
device: &A::Device,
config: &SurfaceConfiguration
) -> Result<(), SurfaceError>
unsafe fn configure( &mut self, device: &A::Device, config: &SurfaceConfiguration ) -> Result<(), SurfaceError>
Configures the surface to use the given device.
Safety
- All gpu work that uses the surface must have been completed.
- All
AcquiredSurfaceTextures must have been destroyed. - All
Api::TextureViews derived from theAcquiredSurfaceTextures must have been destroyed. - All surfaces created using other devices must have been unconfigured before this call.
sourceunsafe fn unconfigure(&mut self, device: &A::Device)
unsafe fn unconfigure(&mut self, device: &A::Device)
Unconfigures the surface on the given device.
Safety
- All gpu work that uses the surface must have been completed.
- All
AcquiredSurfaceTextures must have been destroyed. - All
Api::TextureViews derived from theAcquiredSurfaceTextures must have been destroyed. - The surface must have been configured on the given device.
sourceunsafe fn acquire_texture(
&mut self,
timeout: Option<Duration>
) -> Result<Option<AcquiredSurfaceTexture<A>>, SurfaceError>
unsafe fn acquire_texture( &mut self, timeout: Option<Duration> ) -> Result<Option<AcquiredSurfaceTexture<A>>, SurfaceError>
Returns the next texture to be presented by the swapchain for drawing
A timeout of None means to wait indefinitely, with no timeout.
Portability
Some backends can’t support a timeout when acquiring a texture and the timeout will be ignored.
Returns None on timing out.