Struct gfx_hal::window::SwapchainConfig

pub struct SwapchainConfig {
    pub present_mode: PresentMode,
    pub composite_alpha_mode: CompositeAlphaMode,
    pub format: Format,
    pub extent: Extent2D,
    pub image_count: SwapImageIndex,
    pub image_layers: Layer,
    pub image_usage: Usage,
}

Contains all the data necessary to create a new Swapchain: color, depth, and number of images.

Examples

This type implements the builder pattern, method calls can be easily chained.

let config = SwapchainConfig::new(100, 100, Format::Bgra8Unorm, 2);

Fields

present_mode: PresentMode

Presentation mode.

composite_alpha_mode: CompositeAlphaMode

Alpha composition mode.

format: Format

Format of the backbuffer images.

extent: Extent2D

Requested image extent. Must be in SurfaceCapabilities::extents range.

image_count: SwapImageIndex

Number of images in the swapchain. Must be in SurfaceCapabilities::image_count range.

image_layers: Layer

Number of image layers. Must be lower or equal to SurfaceCapabilities::max_image_layers.

image_usage: Usage

Image usage of the backbuffer images.

Methods

impl SwapchainConfig

pub fn new(
    width: u32,
    height: u32,
    format: Format,
    image_count: SwapImageIndex
) -> Self

Create a new default configuration (color images only).

Examples

pub fn from_caps(
    caps: &SurfaceCapabilities,
    format: Format,
    default_extent: Extent2D
) -> Self

Create a swapchain configuration based on the capabilities returned from a physical device query. If the surface does not specify a current size, default_extent is clamped and used instead.

pub fn with_present_mode(self, mode: PresentMode) -> Self

Specify the presentation mode.

Examples

pub fn with_image_usage(self, usage: Usage) -> Self

Specify the usage of backbuffer images.

Examples

Trait Implementations

impl Clone for SwapchainConfig

fn clone(&self) -> SwapchainConfig

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SwapchainConfig

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

Formats the value using the given formatter.