Struct wgpu_types::SurfaceConfiguration

source ·
#[repr(C)]
pub struct SurfaceConfiguration<V> { pub usage: TextureUsages, pub format: TextureFormat, pub width: u32, pub height: u32, pub present_mode: PresentMode, pub desired_maximum_frame_latency: u32, pub alpha_mode: CompositeAlphaMode, pub view_formats: V, }
Expand description

Configures a Surface for presentation.

Fields§

§usage: TextureUsages

The usage of the swap chain. The only supported usage is RENDER_ATTACHMENT.

§format: TextureFormat

The texture format of the swap chain. The only formats that are guaranteed are Bgra8Unorm and Bgra8UnormSrgb

§width: u32

Width of the swap chain. Must be the same size as the surface, and nonzero.

§height: u32

Height of the swap chain. Must be the same size as the surface, and nonzero.

§present_mode: PresentMode

Presentation mode of the swap chain. Fifo is the only mode guaranteed to be supported. FifoRelaxed, Immediate, and Mailbox will crash if unsupported, while AutoVsync and AutoNoVsync will gracefully do a designed sets of fallbacks if their primary modes are unsupported.

§desired_maximum_frame_latency: u32

Desired maximum number of frames that the presentation engine should queue in advance.

This is a hint to the backend implementation and will always be clamped to the supported range. As a consequence, either the maximum frame latency is set directly on the swap chain, or waits on present are scheduled to avoid exceeding the maximum frame latency if supported, or the swap chain size is set to (max-latency + 1).

Defaults to 2 when created via wgpu::Surface::get_default_config.

Typical values range from 3 to 1, but higher values are possible:

  • Choose 2 or higher for potentially smoother frame display, as it allows to be at least one frame to be queued up. This typically avoids starving the GPU’s work queue. Higher values are useful for achieving a constant flow of frames to the display under varying load.
  • Choose 1 for low latency from frame recording to frame display. ⚠️ If the backend does not support waiting on present, this will cause the CPU to wait for the GPU to finish all work related to the previous frame when calling wgpu::Surface::get_current_texture, causing CPU-GPU serialization (i.e. when wgpu::Surface::get_current_texture returns, the GPU might be idle). It is currently not possible to query this. See https://github.com/gfx-rs/wgpu/issues/2869.
  • A value of 0 is generally not supported and always clamped to a higher value.
§alpha_mode: CompositeAlphaMode

Specifies how the alpha channel of the textures should be handled during compositing.

§view_formats: V

Specifies what view formats will be allowed when calling create_view() on texture returned by get_current_texture().

View formats of the same format as the texture are always allowed.

Note: currently, only the srgb-ness is allowed to change. (ex: Rgba8Unorm texture + Rgba8UnormSrgb view)

Implementations§

source§

impl<V: Clone> SurfaceConfiguration<V>

source

pub fn map_view_formats<M>( &self, fun: impl FnOnce(V) -> M ) -> SurfaceConfiguration<M>

Map view_formats of the texture descriptor into another.

Trait Implementations§

source§

impl<V: Clone> Clone for SurfaceConfiguration<V>

source§

fn clone(&self) -> SurfaceConfiguration<V>

Returns a copy of the value. Read more
1.0.0 · source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
source§

impl<V: Debug> Debug for SurfaceConfiguration<V>

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
source§

impl<V: Hash> Hash for SurfaceConfiguration<V>

source§

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher. Read more
1.3.0 · source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
source§

impl<V: PartialEq> PartialEq for SurfaceConfiguration<V>

source§

fn eq(&self, other: &SurfaceConfiguration<V>) -> bool

This method tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl<V: Eq> Eq for SurfaceConfiguration<V>

source§

impl<V> StructuralPartialEq for SurfaceConfiguration<V>

Auto Trait Implementations§

§

impl<V> Freeze for SurfaceConfiguration<V>
where V: Freeze,

§

impl<V> RefUnwindSafe for SurfaceConfiguration<V>
where V: RefUnwindSafe,

§

impl<V> Send for SurfaceConfiguration<V>
where V: Send,

§

impl<V> Sync for SurfaceConfiguration<V>
where V: Sync,

§

impl<V> Unpin for SurfaceConfiguration<V>
where V: Unpin,

§

impl<V> UnwindSafe for SurfaceConfiguration<V>
where V: UnwindSafe,

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> WasmNotSend for T
where T: Send,

source§

impl<T> WasmNotSendSync for T

source§

impl<T> WasmNotSync for T
where T: Sync,