Enum gfx_hal::image::Layout

pub enum Layout {
    General,
    ColorAttachmentOptimal,
    DepthStencilAttachmentOptimal,
    DepthStencilReadOnlyOptimal,
    ShaderReadOnlyOptimal,
    TransferSrcOptimal,
    TransferDstOptimal,
    Undefined,
    Preinitialized,
    Present,
}

Specifies options for how memory for an image is arranged. These are hints to the GPU driver and may or may not have actual performance effects, but describe constraints on how the data may be used that a program must obey. They do not specify how channel values or such are laid out in memory; the actual image data is considered opaque.

Details may be found in the Vulkan spec

Variants

General

General purpose, no restrictions on usage.

ColorAttachmentOptimal

Must only be used as a color attachment in a framebuffer.

DepthStencilAttachmentOptimal

Must only be used as a depth attachment in a framebuffer.

DepthStencilReadOnlyOptimal

Must only be used as a depth attachment in a framebuffer, or as a read-only depth or stencil buffer in a shader.

ShaderReadOnlyOptimal

Must only be used as a read-only image in a shader.

TransferSrcOptimal

Must only be used as the source for a transfer command.

TransferDstOptimal

Must only be used as the destination for a transfer command.

Undefined

No layout, does not support device access. Only valid as a source layout when transforming data to a specific destination layout or initializing data. Does NOT guarentee that the contents of the source buffer are preserved.

Preinitialized

Like Undefined, but does guarentee that the contents of the source buffer are preserved.

Present

The layout that an image must be in to be presented to the display.

Trait Implementations

impl Clone for Layout

fn clone(&self) -> Layout

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Layout

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

Formats the value using the given formatter.

impl Hash for Layout

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl PartialEq<Layout> for Layout

fn eq(&self, other: &Layout) -> 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 Layout

impl Eq for Layout

impl StructuralEq for Layout

impl StructuralPartialEq for Layout