Enum vulkano::command_buffer::RenderPassError

pub enum RenderPassError {
    SyncCommandBufferBuilderError(SyncCommandBufferBuilderError),
    RequirementNotMet {
        required_for: &'static str,
        requires_one_of: RequiresOneOf,
    },
    AttachmentImageMissingUsage {
        attachment_index: u32,
        usage: &'static str,
    },
    AutoExtentAttachmentsEmpty,
    AutoLayersAttachmentsEmpty,
    ClearAttachmentNotCompatible {
        clear_attachment: ClearAttachment,
        attachment_format: Option<Format>,
    },
    ClearValueMissing {
        attachment_index: u32,
    },
    ClearValueNotCompatible {
        clear_value: ClearValue,
        attachment_index: u32,
        attachment_format: Format,
    },
    ColorAttachmentIndexOutOfRange {
        color_attachment_index: u32,
        num_color_attachments: u32,
    },
    ColorAttachmentLayoutInvalid {
        attachment_index: u32,
    },
    ColorAttachmentMissingUsage {
        attachment_index: u32,
    },
    ColorAttachmentResolveFormatMismatch {
        attachment_index: u32,
    },
    ColorAttachmentResolveLayoutInvalid {
        attachment_index: u32,
    },
    ColorAttachmentResolveModeNotSupported {
        attachment_index: u32,
    },
    ColorAttachmentResolveMultisampled {
        attachment_index: u32,
    },
    ColorAttachmentSamplesMismatch {
        attachment_index: u32,
    },
    ColorAttachmentWithResolveNotMultisampled {
        attachment_index: u32,
    },
    ContentsForbiddenInSecondaryCommandBuffer,
    DepthAttachmentFormatUsageNotSupported,
    DepthAttachmentLayoutInvalid,
    DepthAttachmentMissingUsage,
    DepthAttachmentResolveFormatMismatch,
    DepthAttachmentResolveLayoutInvalid,
    DepthAttachmentResolveModeNotSupported,
    DepthAttachmentResolveMultisampled,
    DepthAttachmentSamplesMismatch,
    DepthAttachmentWithResolveNotMultisampled,
    DepthStencilAttachmentImageViewMismatch,
    DepthStencilAttachmentResolveImageViewMismatch,
    DepthStencilAttachmentResolveModesNotSupported,
    ForbiddenInsideRenderPass,
    ForbiddenOutsideRenderPass,
    ForbiddenWithBeginRendering,
    ForbiddenWithBeginRenderPass,
    ForbiddenWithInheritedRenderPass,
    ForbiddenWithSubpassContents {
        contents: SubpassContents,
    },
    FramebufferNotCompatible,
    MaxColorAttachmentsExceeded {
        color_attachment_count: u32,
        max: u32,
    },
    MaxMultiviewViewCountExceeded {
        view_count: u32,
        max: u32,
    },
    MultiviewLayersInvalid,
    MultiviewRectArrayLayersInvalid {
        rect_index: usize,
    },
    NoSubpassesRemaining {
        current_subpass: u32,
    },
    NotSupportedByQueueFamily,
    QueryIsActive,
    RectArrayLayersEmpty {
        rect_index: usize,
    },
    RectArrayLayersOutOfBounds {
        rect_index: usize,
    },
    RectExtentZero {
        rect_index: usize,
    },
    RectOutOfBounds {
        rect_index: usize,
    },
    RenderAreaOutOfBounds,
    StencilAttachmentFormatUsageNotSupported,
    StencilAttachmentLayoutInvalid,
    StencilAttachmentMissingUsage,
    StencilAttachmentResolveFormatMismatch,
    StencilAttachmentResolveLayoutInvalid,
    StencilAttachmentResolveModeNotSupported,
    StencilAttachmentResolveMultisampled,
    StencilAttachmentSamplesMismatch,
    StencilAttachmentWithResolveNotMultisampled,
    SubpassesRemaining {
        current_subpass: u32,
        remaining_subpasses: u32,
    },
}

Error that can happen when recording a render pass command.

Variants

SyncCommandBufferBuilderError(SyncCommandBufferBuilderError)

RequirementNotMet

Fields

required_for: &'static str

requires_one_of: RequiresOneOf

AttachmentImageMissingUsage

Fields

attachment_index: u32

usage: &'static str

A framebuffer image did not have the required usage enabled.

AutoExtentAttachmentsEmpty

One of the elements of render_pass_extent is zero, but no attachment images were given to calculate the extent from.

AutoLayersAttachmentsEmpty

layer_count is zero, but no attachment images were given to calculate the number of layers from.

ClearAttachmentNotCompatible

Fields

clear_attachment: ClearAttachment

attachment_format: Option<Format>

A clear attachment value is not compatible with the attachment’s format.

ClearValueMissing

Fields

attachment_index: u32

A clear value for a render pass attachment is missing.

ClearValueNotCompatible

Fields

clear_value: ClearValue

attachment_index: u32

attachment_format: Format

A clear value provided for a render pass attachment is not compatible with the attachment’s format.

ColorAttachmentIndexOutOfRange

Fields

color_attachment_index: u32

num_color_attachments: u32

An attachment clear value specifies a color_attachment index that is not less than the number of color attachments in the subpass.

ColorAttachmentLayoutInvalid

Fields

attachment_index: u32

A color attachment has a layout that is not supported.

ColorAttachmentMissingUsage

Fields

attachment_index: u32

A color attachment is missing the color_attachment usage.

ColorAttachmentResolveFormatMismatch

Fields

attachment_index: u32

A color resolve attachment has a format value different from the corresponding color attachment.

ColorAttachmentResolveLayoutInvalid

Fields

attachment_index: u32

A color resolve attachment has a layout that is not supported.

ColorAttachmentResolveModeNotSupported

Fields

attachment_index: u32

A color resolve attachment has a resolve mode that is not supported.

ColorAttachmentResolveMultisampled

Fields

attachment_index: u32

A color resolve attachment has a samples value other than SampleCount::Sample1.

ColorAttachmentSamplesMismatch

Fields

attachment_index: u32

A color attachment has a samples value that is different from the first color attachment.

ColorAttachmentWithResolveNotMultisampled

Fields

attachment_index: u32

A color attachment with a resolve attachment has a samples value of SampleCount::Sample1.

ContentsForbiddenInSecondaryCommandBuffer

The contents SubpassContents::SecondaryCommandBuffers is not allowed inside a secondary command buffer.

DepthAttachmentFormatUsageNotSupported

The depth attachment has a format that does not support that usage.

DepthAttachmentLayoutInvalid

The depth attachment has a layout that is not supported.

DepthAttachmentMissingUsage

The depth attachment is missing the depth_stencil_attachment usage.

DepthAttachmentResolveFormatMismatch

The depth resolve attachment has a format value different from the corresponding depth attachment.

DepthAttachmentResolveLayoutInvalid

The depth resolve attachment has a layout that is not supported.

DepthAttachmentResolveModeNotSupported

The depth resolve attachment has a resolve mode that is not supported.

DepthAttachmentResolveMultisampled

The depth resolve attachment has a samples value other than SampleCount::Sample1.

DepthAttachmentSamplesMismatch

The depth attachment has a samples value that is different from the first color attachment.

DepthAttachmentWithResolveNotMultisampled

The depth attachment has a resolve attachment and has a samples value of SampleCount::Sample1.

DepthStencilAttachmentImageViewMismatch

The depth and stencil attachments have different image views.

DepthStencilAttachmentResolveImageViewMismatch

The depth and stencil resolve attachments have different image views.

DepthStencilAttachmentResolveModesNotSupported

The combination of depth and stencil resolve modes is not supported by the device.

ForbiddenInsideRenderPass

Operation forbidden inside a render pass.

ForbiddenOutsideRenderPass

Operation forbidden outside a render pass.

ForbiddenWithBeginRendering

Operation forbidden inside a render pass instance that was begun with begin_rendering.

ForbiddenWithBeginRenderPass

Operation forbidden inside a render pass instance that was begun with begin_render_pass.

ForbiddenWithInheritedRenderPass

Operation forbidden inside a render pass instance that is inherited by a secondary command buffer.

ForbiddenWithSubpassContents

Fields

contents: SubpassContents

Operation forbidden inside a render subpass with the specified contents.

FramebufferNotCompatible

The framebuffer is not compatible with the render pass.

MaxColorAttachmentsExceeded

Fields

color_attachment_count: u32

max: u32

The max_color_attachments limit has been exceeded.

MaxMultiviewViewCountExceeded

Fields

view_count: u32

max: u32

The max_multiview_view_count limit has been exceeded.

MultiviewLayersInvalid

The render pass uses multiview, but layer_count was not 0 or 1.

MultiviewRectArrayLayersInvalid

Fields

rect_index: usize

The render pass uses multiview, and in a clear rectangle, array_layers was not 0..1.

NoSubpassesRemaining

Fields

current_subpass: u32

Tried to advance to the next subpass, but there are no subpasses remaining in the render pass.

NotSupportedByQueueFamily

The queue family doesn’t allow this operation.

QueryIsActive

A query is active that conflicts with the current operation.

RectArrayLayersEmpty

Fields

rect_index: usize

A clear rectangle’s array_layers is empty.

RectArrayLayersOutOfBounds

Fields

rect_index: usize

A clear rectangle’s array_layers is outside the range of layers of the attachments.

RectExtentZero

Fields

rect_index: usize

A clear rectangle’s extent is zero.

RectOutOfBounds

Fields

rect_index: usize

A clear rectangle’s offset and extent are outside the render area of the render pass instance.

RenderAreaOutOfBounds

The render area’s offset and extent are outside the extent of the framebuffer.

StencilAttachmentFormatUsageNotSupported

The stencil attachment has a format that does not support that usage.

StencilAttachmentLayoutInvalid

The stencil attachment has a layout that is not supported.

StencilAttachmentMissingUsage

The stencil attachment is missing the depth_stencil_attachment usage.

StencilAttachmentResolveFormatMismatch

The stencil resolve attachment has a format value different from the corresponding stencil attachment.

StencilAttachmentResolveLayoutInvalid

The stencil resolve attachment has a layout that is not supported.

StencilAttachmentResolveModeNotSupported

The stencil resolve attachment has a resolve mode that is not supported.

StencilAttachmentResolveMultisampled

The stencil resolve attachment has a samples value other than SampleCount::Sample1.

StencilAttachmentSamplesMismatch

The stencil attachment has a samples value that is different from the first color attachment or the depth attachment.

StencilAttachmentWithResolveNotMultisampled

The stencil attachment has a resolve attachment and has a samples value of SampleCount::Sample1.

SubpassesRemaining

Fields

current_subpass: u32

remaining_subpasses: u32

Tried to end a render pass with subpasses still remaining in the render pass.

Trait Implementations

impl Clone for RenderPassError

fn clone(&self) -> RenderPassError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RenderPassError

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

Formats the value using the given formatter.

impl Display for RenderPassError

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

Formats the value using the given formatter.

impl Error for RenderPassError

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide(&'a self, demand: &mut Demand<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type based access to context intended for error reports.

impl From<SyncCommandBufferBuilderError> for RenderPassError

fn from(err: SyncCommandBufferBuilderError) -> Self

Converts to this type from the input type.