Enum vulkano::image::ImageLayout

#[repr(u32)]
pub enum ImageLayout {
    Undefined,
    General,
    ColorAttachmentOptimal,
    DepthStencilAttachmentOptimal,
    DepthStencilReadOnlyOptimal,
    ShaderReadOnlyOptimal,
    TransferSrcOptimal,
    TransferDstOptimal,
    Preinitialized,
    PresentSrc,
}

Layout of an image.

Note: In vulkano, image layouts are mostly a low-level detail. You can ignore them, unless you use an unsafe function that states in its documentation that you must take care of an image’s layout.

In the Vulkan API, each mipmap level of each array layer is in one of the layouts of this enum.

Unless you use some sort of high-level shortcut function, an image always starts in either the Undefined or the Preinitialized layout. Before you can use an image for a given purpose, you must ensure that the image in question is in the layout required for that purpose. For example if you want to write data to an image, you must first transition the image to the TransferDstOptimal layout. The General layout can also be used as a general-purpose fit-all layout, but using it will result in slower operations.

Transitioning between layouts can only be done through a GPU-side operation that is part of a command buffer.

Variants

Undefined

General

ColorAttachmentOptimal

DepthStencilAttachmentOptimal

DepthStencilReadOnlyOptimal

ShaderReadOnlyOptimal

TransferSrcOptimal

TransferDstOptimal

Preinitialized

PresentSrc

Trait Implementations

impl Clone for ImageLayout

fn clone(&self) -> ImageLayout

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ImageLayout

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

Formats the value using the given formatter.

impl PartialEq<ImageLayout> for ImageLayout

fn eq(&self, other: &ImageLayout) -> bool

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

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.

impl Copy for ImageLayout

impl Eq for ImageLayout

impl StructuralEq for ImageLayout

impl StructuralPartialEq for ImageLayout