[−][src]Struct bedrock::vk::VkAttachmentDescription

#[repr(C)]
pub struct VkAttachmentDescription {
    pub flags: VkAttachmentDescriptionFlags,
    pub format: VkFormat,
    pub samples: VkSampleCountFlags,
    pub loadOp: VkAttachmentLoadOp,
    pub storeOp: VkAttachmentStoreOp,
    pub stencilLoadOp: VkAttachmentLoadOp,
    pub stencilStoreOp: VkAttachmentStoreOp,
    pub initialLayout: VkImageLayout,
    pub finalLayout: VkImageLayout,
}

Fields

flags: VkAttachmentDescriptionFlags

VkAttachmentDescriptionFlagBitsのビットマスクで、アタッチメントの追加プロパティを指定する

適用可能なビットマスク

0: 指定なし
VK_ATTACHMENT_DESCRIPTION_MAY_ALIAS_BIT: このアタッチメントは同一メモリ上の他のアタッチメントをエイリアスしていることを表す

format: VkFormat

アタッチメントとして使用されるイメージのピクセルフォーマットをVkFormatで指定する

samples: VkSampleCountFlags

VkSampleCountFlagBitsで定義される、イメージのサンプル数

適用可能なビットマスク

1, 2, 4, 8, 16, 32, 64

loadOp: VkAttachmentLoadOp

アタッチメントの色/深度が、最初に使用する Subpass の開始時にどうあるべきかを指定する

適用可能な値

VK_ATTACHMENT_LOAD_OP_LOAD: 以前のイメージの内容を引き継ぐことを表す
VK_ATTACHMENT_LOAD_OP_CLEAR: 特定の値(RenderPass を開始する際に指定)でクリアされることを表す
VK_ATTACHMENT_LOAD_OP_DONT_CARE: 以前の内容が引き継がれる必要はないことを表す。描画エリア内のアタッチメントの内容は未定義となる

必要なアクセスタイプ

	深度を持つアタッチメントの場合	色を持つアタッチメントの場合
`VK_ATTACHMENT_LOAD_OP_LOAD`	`VK_ACCESS_DEPTH_STENCIL_ATTACHMENT_READ_BIT`	`VK_ACCESS_COLOR_ATTTACHMENT_READ_BIT`
`VK_ATTACHMENT_LOAD_OP_CLEAR`	`VK_ACCESS_DEPTH_STENCIL_ATTACHMENT_WRITE_BIT`	`VK_ACCESS_COLOR_ATTTACHMENT_WRITE_BIT`
`VK_ATTACHMENT_LOAD_OP_DONT_CARE`	`VK_ACCESS_DEPTH_STENCIL_ATTACHMENT_WRITE_BIT`	`VK_ACCESS_COLOR_ATTTACHMENT_WRITE_BIT`

storeOp: VkAttachmentStoreOp

アタッチメントの色/深度を、最後に使用した Subpass の終了時にどう扱うかを指定する

適用可能な値

VK_ATTACHMENT_STORE_OP_STORE: 描画エリア内において、パス中で生成された内容はメモリに書き戻されるようにする
VK_ATTACHMENT_STORE_OP_DONT_CARE: 描画エリア内の内容は今後必要がなく、破棄されても構わないことを表す。アタッチメントの描画エリア内の内容は未定義となる。

必要なアクセスタイプ

深度を持つアタッチメントの場合: どちらの値もVK_ACCESS_DEPTH_STENCIL_ATTACHMENT_WRITE_BITを必要とする
色を持つアタッチメントの場合: どちらの値もVK_ACCESS_COLOR_ATTACHMENT_WRITE_BITを必要とする

stencilLoadOp: VkAttachmentLoadOp

アタッチメントのステンシル値が、最初に使用する Subpass の開始時にどうあるべきかを指定する

適用可能な値

VK_ATTACHMENT_LOAD_OP_LOAD: 以前のイメージの内容を引き継ぐことを表す
VK_ATTACHMENT_LOAD_OP_CLEAR: 特定の値(RenderPass を開始する際に指定)でクリアされることを表す
VK_ATTACHMENT_LOAD_OP_DONT_CARE: 以前の内容が引き継がれる必要はないことを表す。描画エリア内のアタッチメントの内容は未定義となる

必要なアクセスタイプ

VK_ATTACHMENT_LOAD_OP_LOADはVK_ACCESS_DEPTH_STENCIL_ATTACHMENT_READ_BITを必要とする
VK_ATTACHMENT_LOAD_OP_CLEARはVK_ACCESS_DEPTH_STENCIL_ATTACHMENT_WRITE_BITを必要とする
VK_ATTACHMENT_LOAD_OP_DONT_CAREはVK_ACCESS_DEPTH_STENCIL_ATTACHMENT_WRITE_BITを必要とする

stencilStoreOp: VkAttachmentStoreOp

アタッチメントのステンシル値を、最後に使用した Subpass の終了時にどう扱うかを指定する

適用可能な値

VK_ATTACHMENT_STORE_OP_STORE: 描画エリア内において、パス中で生成された内容はメモリに書き戻されるようにする
VK_ATTACHMENT_STORE_OP_DONT_CARE: 描画エリア内の内容は今後必要がなく、破棄されても構わないことを表す。アタッチメントの描画エリア内の内容は未定義となる。