Struct vulkano::image::swapchain::SwapchainImage [−][src]
pub struct SwapchainImage<W> { /* fields omitted */ }
An image that is part of a swapchain.
Creating a SwapchainImage
is automatically done when creating a swapchain.
A swapchain image is special in the sense that it can only be used after being acquired by
calling the acquire
method on the swapchain. You have no way to know in advance which
swapchain image is going to be acquired, so you should keep all of them alive.
After a swapchain image has been acquired, you are free to perform all the usual operations on it. When you are done you can then present the image (by calling the corresponding method on the swapchain), which will have the effect of showing the content of the image to the screen. Once an image has been presented, it can no longer be used unless it is acquired again.
Methods
impl<W> SwapchainImage<W>
[src]
impl<W> SwapchainImage<W>
pub unsafe fn from_raw(
swapchain: Arc<Swapchain<W>>,
id: usize
) -> Result<Arc<SwapchainImage<W>>, OomError>
[src]
pub unsafe fn from_raw(
swapchain: Arc<Swapchain<W>>,
id: usize
) -> Result<Arc<SwapchainImage<W>>, OomError>
Builds a SwapchainImage
from raw components.
This is an internal method that you shouldn't call.
pub fn dimensions(&self) -> [u32; 2]
[src]
pub fn dimensions(&self) -> [u32; 2]
Returns the dimensions of the image.
A SwapchainImage
is always two-dimensional.
pub fn swapchain(&self) -> &Arc<Swapchain<W>>
[src]
pub fn swapchain(&self) -> &Arc<Swapchain<W>>
Returns the swapchain this image belongs to.
Trait Implementations
impl<W> ImageAccess for SwapchainImage<W>
[src]
impl<W> ImageAccess for SwapchainImage<W>
fn inner(&self) -> ImageInner
[src]
fn inner(&self) -> ImageInner
Returns the inner unsafe image object used by this image.
fn initial_layout_requirement(&self) -> ImageLayout
[src]
fn initial_layout_requirement(&self) -> ImageLayout
Returns the layout that the image has when it is first used in a primary command buffer. Read more
fn final_layout_requirement(&self) -> ImageLayout
[src]
fn final_layout_requirement(&self) -> ImageLayout
Returns the layout that the image must be returned to before the end of the command buffer. Read more
fn conflicts_buffer(&self, other: &BufferAccess) -> bool
[src]
fn conflicts_buffer(&self, other: &BufferAccess) -> bool
Returns true if an access to self
potentially overlaps the same memory as an access to other
. Read more
fn conflicts_image(&self, other: &ImageAccess) -> bool
[src]
fn conflicts_image(&self, other: &ImageAccess) -> bool
Returns true if an access to self
potentially overlaps the same memory as an access to other
. Read more
fn conflict_key(&self) -> u64
[src]
fn conflict_key(&self) -> u64
Returns a key that uniquely identifies the memory content of the image. Two ranges that potentially overlap in memory must return the same key. Read more
fn try_gpu_lock(&self, _: bool, _: ImageLayout) -> Result<(), AccessError>
[src]
fn try_gpu_lock(&self, _: bool, _: ImageLayout) -> Result<(), AccessError>
Locks the resource for usage on the GPU. Returns an error if the lock can't be acquired. Read more
unsafe fn increase_gpu_lock(&self)
[src]
unsafe fn increase_gpu_lock(&self)
Locks the resource for usage on the GPU. Supposes that the resource is already locked, and simply increases the lock by one. Read more
unsafe fn unlock(&self, _: Option<ImageLayout>)
[src]
unsafe fn unlock(&self, _: Option<ImageLayout>)
Unlocks the resource previously acquired with try_gpu_lock
or increase_gpu_lock
. Read more
fn format(&self) -> Format
[src]
fn format(&self) -> Format
Returns the format of this image.
fn has_color(&self) -> bool
[src]
fn has_color(&self) -> bool
Returns true if the image is a color image.
fn has_depth(&self) -> bool
[src]
fn has_depth(&self) -> bool
Returns true if the image has a depth component. In other words, if it is a depth or a depth-stencil format. Read more
fn has_stencil(&self) -> bool
[src]
fn has_stencil(&self) -> bool
Returns true if the image has a stencil component. In other words, if it is a stencil or a depth-stencil format. Read more
fn mipmap_levels(&self) -> u32
[src]
fn mipmap_levels(&self) -> u32
Returns the number of mipmap levels of this image.
fn samples(&self) -> u32
[src]
fn samples(&self) -> u32
Returns the number of samples of this image.
fn dimensions(&self) -> ImageDimensions
[src]
fn dimensions(&self) -> ImageDimensions
Returns the dimensions of the image.
fn supports_blit_source(&self) -> bool
[src]
fn supports_blit_source(&self) -> bool
Returns true if the image can be used as a source for blits.
fn supports_blit_destination(&self) -> bool
[src]
fn supports_blit_destination(&self) -> bool
Returns true if the image can be used as a destination for blits.
unsafe fn forced_undefined_initial_layout(
self,
preinitialized: bool
) -> ImageAccessFromUndefinedLayout<Self> where
Self: Sized,
[src]
unsafe fn forced_undefined_initial_layout(
self,
preinitialized: bool
) -> ImageAccessFromUndefinedLayout<Self> where
Self: Sized,
Wraps around this ImageAccess
and returns an identical ImageAccess
but whose initial layout requirement is either Undefined
or Preinitialized
. Read more
impl<W> ImageClearValue<<Format as FormatDesc>::ClearValue> for SwapchainImage<W>
[src]
impl<W> ImageClearValue<<Format as FormatDesc>::ClearValue> for SwapchainImage<W>
fn decode(
&self,
value: <Format as FormatDesc>::ClearValue
) -> Option<ClearValue>
[src]
fn decode(
&self,
value: <Format as FormatDesc>::ClearValue
) -> Option<ClearValue>
impl<P, W> ImageContent<P> for SwapchainImage<W>
[src]
impl<P, W> ImageContent<P> for SwapchainImage<W>
fn matches_format(&self) -> bool
[src]
fn matches_format(&self) -> bool
Checks whether pixels of type P
match the format of the image.
impl<W> ImageViewAccess for SwapchainImage<W>
[src]
impl<W> ImageViewAccess for SwapchainImage<W>
fn parent(&self) -> &ImageAccess
[src]
fn parent(&self) -> &ImageAccess
fn dimensions(&self) -> Dimensions
[src]
fn dimensions(&self) -> Dimensions
Returns the dimensions of the image view.
fn inner(&self) -> &UnsafeImageView
[src]
fn inner(&self) -> &UnsafeImageView
Returns the inner unsafe image view object used by this image view.
fn descriptor_set_storage_image_layout(&self) -> ImageLayout
[src]
fn descriptor_set_storage_image_layout(&self) -> ImageLayout
Returns the image layout to use in a descriptor with the given subresource.
fn descriptor_set_combined_image_sampler_layout(&self) -> ImageLayout
[src]
fn descriptor_set_combined_image_sampler_layout(&self) -> ImageLayout
Returns the image layout to use in a descriptor with the given subresource.
fn descriptor_set_sampled_image_layout(&self) -> ImageLayout
[src]
fn descriptor_set_sampled_image_layout(&self) -> ImageLayout
Returns the image layout to use in a descriptor with the given subresource.
fn descriptor_set_input_attachment_layout(&self) -> ImageLayout
[src]
fn descriptor_set_input_attachment_layout(&self) -> ImageLayout
Returns the image layout to use in a descriptor with the given subresource.
fn identity_swizzle(&self) -> bool
[src]
fn identity_swizzle(&self) -> bool
Returns true if the view doesn't use components swizzling. Read more
fn format(&self) -> Format
[src]
fn format(&self) -> Format
Returns the format of this view. This can be different from the parent's format.
fn samples(&self) -> u32
[src]
fn samples(&self) -> u32
fn can_be_sampled(&self, _sampler: &Sampler) -> bool
[src]
fn can_be_sampled(&self, _sampler: &Sampler) -> bool
Returns true if the given sampler can be used with this image view. Read more
Auto Trait Implementations
impl<W> Send for SwapchainImage<W> where
W: Send + Sync,
impl<W> Send for SwapchainImage<W> where
W: Send + Sync,
impl<W> Sync for SwapchainImage<W> where
W: Send + Sync,
impl<W> Sync for SwapchainImage<W> where
W: Send + Sync,