Struct vulkano::swapchain::Swapchain

pub struct Swapchain<W> { /* private fields */ }

Contains the swapping system and the images that can be shown on a surface.

Implementations

impl<W> Swapchain<W>

pub fn new<F, S>(
    device: Arc<Device>,
    surface: Arc<Surface<W>>,
    num_images: u32,
    format: F,
    dimensions: [u32; 2],
    layers: u32,
    usage: ImageUsage,
    sharing: S,
    transform: SurfaceTransform,
    alpha: CompositeAlpha,
    mode: PresentMode,
    clipped: bool,
    old_swapchain: Option<&Arc<Swapchain<W>>>
) -> Result<(Arc<Swapchain<W>>, Vec<Arc<SwapchainImage<W>>>), SwapchainCreationError>where
    F: FormatDesc,
    S: Into<SharingMode>,

Builds a new swapchain. Allocates images who content can be made visible on a surface.

See also the Surface::get_capabilities function which returns the values that are supported by the implementation. All the parameters that you pass to Swapchain::new must be supported.

The clipped parameter indicates whether the implementation is allowed to discard rendering operations that affect regions of the surface which aren’t visible. This is important to take into account if your fragment shader has side-effects or if you want to read back the content of the image afterwards.

This function returns the swapchain plus a list of the images that belong to the swapchain. The order in which the images are returned is important for the acquire_next_image and present functions.

Panic

• Panics if the device and the surface don’t belong to the same instance.
• Panics if usage is empty.

pub fn recreate_with_dimension(
    &self,
    dimensions: [u32; 2]
) -> Result<(Arc<Swapchain<W>>, Vec<Arc<SwapchainImage<W>>>), SwapchainCreationError>

Recreates the swapchain with new dimensions.

pub fn raw_image(&self, offset: usize) -> Option<ImageInner<'_>>

Returns of the images that belong to this swapchain.

pub fn num_images(&self) -> u32

Returns the number of images of the swapchain.

See the documentation of Swapchain::new.

pub fn format(&self) -> Format

Returns the format of the images of the swapchain.

See the documentation of Swapchain::new.

pub fn dimensions(&self) -> [u32; 2]

Returns the dimensions of the images of the swapchain.

See the documentation of Swapchain::new.

pub fn layers(&self) -> u32

Returns the number of layers of the images of the swapchain.

See the documentation of Swapchain::new.

pub fn transform(&self) -> SurfaceTransform

Returns the transform that was passed when creating the swapchain.

See the documentation of Swapchain::new.

pub fn composite_alpha(&self) -> CompositeAlpha

Returns the alpha mode that was passed when creating the swapchain.

See the documentation of Swapchain::new.

pub fn present_mode(&self) -> PresentMode

Returns the present mode that was passed when creating the swapchain.

See the documentation of Swapchain::new.

pub fn clipped(&self) -> bool

Returns the value of clipped that was passed when creating the swapchain.

See the documentation of Swapchain::new.

Trait Implementations

impl<W> Debug for Swapchain<W>

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

Formats the value using the given formatter.

impl<W> DeviceOwned for Swapchain<W>

fn device(&self) -> &Arc<Device>

Returns the device that owns Self.

impl<W> Drop for Swapchain<W>

fn drop(&mut self)

Executes the destructor for this type.

impl<W> VulkanObject for Swapchain<W>

type Object = u64

The type of the object.

const TYPE: DebugReportObjectTypeEXT = 27u32

The DebugReportObjectTypeEXT of the internal Vulkan handle.

fn internal_object(&self) -> SwapchainKHR

Returns a reference to the object.