Struct vulkano::pipeline::GraphicsPipeline

pub struct GraphicsPipeline<VertexDefinition, Layout, RenderP> { /* fields omitted */ }

Defines how the implementation should perform a draw operation.

This object contains the shaders and the various fixed states that describe how the implementation should perform the various operations needed by a draw command.

Methods

impl GraphicsPipeline<(), (), ()>

pub fn start<'a>( ) -> GraphicsPipelineBuilder<BufferlessDefinition, EmptyEntryPointDummy, (), EmptyEntryPointDummy, (), EmptyEntryPointDummy, (), EmptyEntryPointDummy, (), EmptyEntryPointDummy, (), ()>

Starts the building process of a graphics pipeline. Returns a builder object that you can fill with the various parameters.

impl<Mv, L, Rp> GraphicsPipeline<Mv, L, Rp>

pub fn vertex_definition(&self) -> &Mv

Returns the vertex definition used in the constructor.

pub fn device(&self) -> &Arc<Device>

Returns the device used to create this pipeline.

impl<Mv, L, Rp> GraphicsPipeline<Mv, L, Rp> where     L: PipelineLayoutAbstract,

pub fn layout(&self) -> &L

Returns the pipeline layout used in the constructor.

impl<Mv, L, Rp> GraphicsPipeline<Mv, L, Rp> where     Rp: RenderPassDesc,

pub fn subpass(&self) -> Subpass<&Rp>

Returns the pass used in the constructor.

impl<Mv, L, Rp> GraphicsPipeline<Mv, L, Rp>

pub fn render_pass(&self) -> &Rp

Returns the render pass used in the constructor.

pub fn has_dynamic_line_width(&self) -> bool

Returns true if the line width used by this pipeline is dynamic.

pub fn num_viewports(&self) -> u32

Returns the number of viewports and scissors of this pipeline.

pub fn has_dynamic_viewports(&self) -> bool

Returns true if the viewports used by this pipeline are dynamic.

pub fn has_dynamic_scissors(&self) -> bool

Returns true if the scissors used by this pipeline are dynamic.

pub fn has_dynamic_depth_bounds(&self) -> bool

Returns true if the depth bounds used by this pipeline are dynamic.

pub fn has_dynamic_stencil_compare_mask(&self) -> bool

Returns true if the stencil compare masks used by this pipeline are dynamic.

pub fn has_dynamic_stencil_write_mask(&self) -> bool

Returns true if the stencil write masks used by this pipeline are dynamic.

pub fn has_dynamic_stencil_reference(&self) -> bool

Returns true if the stencil references used by this pipeline are dynamic.

Trait Implementations

impl<Mv, L, Rp> PipelineLayoutAbstract for GraphicsPipeline<Mv, L, Rp> where     L: PipelineLayoutAbstract,

fn sys(&self) -> PipelineLayoutSys

Returns an opaque object that allows internal access to the pipeline layout.

fn descriptor_set_layout(     &self,     index: usize ) -> Option<&Arc<UnsafeDescriptorSetLayout>>

Returns the UnsafeDescriptorSetLayout object of the specified set index.

impl<Mv, L, Rp> PipelineLayoutDesc for GraphicsPipeline<Mv, L, Rp> where     L: PipelineLayoutDesc,

fn num_sets(&self) -> usize

Returns the number of sets in the layout. Includes possibly empty sets.

fn num_bindings_in_set(&self, set: usize) -> Option<usize>

Returns the number of descriptors in the set. Includes possibly empty descriptors.

fn descriptor(&self, set: usize, binding: usize) -> Option<DescriptorDesc>

Returns the descriptor for the given binding of the given set.

fn num_push_constants_ranges(&self) -> usize

Returns the number of push constant ranges of the layout.

fn push_constants_range(&self, num: usize) -> Option<PipelineLayoutDescPcRange>

Returns a description of the given push constants range.

fn provided_set_layout(     &self,     _set: usize ) -> Option<Arc<UnsafeDescriptorSetLayout>>

If the PipelineLayoutDesc implementation is able to provide an existing UnsafeDescriptorSetLayout for a given set, it can do so by returning it here.

fn union<T>(self, other: T) -> PipelineLayoutDescUnion<Self, T> where     Self: Sized,

Builds the union of this layout and another.

fn check_against_limits(     &self,     device: &Device ) -> Result<(), PipelineLayoutLimitsError>

Checks whether this description fulfills the device limits requirements.

fn build(     self,     device: Arc<Device> ) -> Result<PipelineLayout<Self>, PipelineLayoutCreationError> where     Self: Sized,

Turns the layout description into a PipelineLayout object that can be used by Vulkan.

impl<Mv, L, Rp> DeviceOwned for GraphicsPipeline<Mv, L, Rp>

fn device(&self) -> &Arc<Device>

Returns the device that owns Self.

impl<Mv, L, Rp> Debug for GraphicsPipeline<Mv, L, Rp>

fn fmt(&self, fmt: &mut Formatter) -> Result<(), Error>

Formats the value using the given formatter.

impl<Mv, L, Rp> RenderPassAbstract for GraphicsPipeline<Mv, L, Rp> where     Rp: RenderPassAbstract,

fn inner(&self) -> RenderPassSys

Returns an opaque object representing the render pass' internals.

impl<Mv, L, Rp> RenderPassDesc for GraphicsPipeline<Mv, L, Rp> where     Rp: RenderPassDesc,

fn num_attachments(&self) -> usize

Returns the number of attachments of the render pass.

fn attachment_desc(&self, num: usize) -> Option<LayoutAttachmentDescription>

Returns the description of an attachment.

fn num_subpasses(&self) -> usize

Returns the number of subpasses of the render pass.

fn subpass_desc(&self, num: usize) -> Option<LayoutPassDescription>

Returns the description of a subpass.

fn num_dependencies(&self) -> usize

Returns the number of dependencies of the render pass.

fn dependency_desc(&self, num: usize) -> Option<LayoutPassDependencyDescription>

Returns the description of a dependency.

Important traits for RenderPassDescAttachments<'a, R>

impl<'a, R: ?Sized + 'a> Iterator for RenderPassDescAttachments<'a, R> where
    R: RenderPassDesc,  type Item = LayoutAttachmentDescription;

fn attachment_descs(&self) -> RenderPassDescAttachments<Self> where     Self: Sized,

Returns an iterator to the list of attachments.

Important traits for RenderPassDescSubpasses<'a, R>

impl<'a, R: ?Sized + 'a> Iterator for RenderPassDescSubpasses<'a, R> where
    R: RenderPassDesc,  type Item = LayoutPassDescription;

fn subpass_descs(&self) -> RenderPassDescSubpasses<Self> where     Self: Sized,

Returns an iterator to the list of subpasses.

Important traits for RenderPassDescDependencies<'a, R>

impl<'a, R: ?Sized + 'a> Iterator for RenderPassDescDependencies<'a, R> where
    R: RenderPassDesc,  type Item = LayoutPassDependencyDescription;

fn dependency_descs(&self) -> RenderPassDescDependencies<Self> where     Self: Sized,

Returns an iterator to the list of dependencies.

fn is_compatible_with<T: ?Sized>(&self, other: &T) -> bool where     Self: Sized,     T: RenderPassDesc,

Returns true if this render pass is compatible with another render pass.

fn build_render_pass(     self,     device: Arc<Device> ) -> Result<RenderPass<Self>, RenderPassCreationError> where     Self: Sized,

Builds a render pass from this description.

fn num_color_attachments(&self, subpass: u32) -> Option<u32>

Returns the number of color attachments of a subpass. Returns None if out of range.

fn num_samples(&self, subpass: u32) -> Option<u32>

Returns the number of samples of the attachments of a subpass. Returns None if out of range or if the subpass has no attachment. TODO: return an enum instead?

fn has_depth_stencil_attachment(&self, subpass: u32) -> Option<(bool, bool)>

Returns a tuple whose first element is true if there's a depth attachment, and whose second element is true if there's a stencil attachment. Returns None if out of range.

fn has_depth(&self, subpass: u32) -> Option<bool>

Returns true if a subpass has a depth attachment or a depth-stencil attachment.

fn has_writable_depth(&self, subpass: u32) -> Option<bool>

Returns true if a subpass has a depth attachment or a depth-stencil attachment whose layout is not DepthStencilReadOnlyOptimal.

fn has_stencil(&self, subpass: u32) -> Option<bool>

Returns true if a subpass has a stencil attachment or a depth-stencil attachment.

fn has_writable_stencil(&self, subpass: u32) -> Option<bool>

Returns true if a subpass has a stencil attachment or a depth-stencil attachment whose layout is not DepthStencilReadOnlyOptimal.

impl<C, Mv, L, Rp> RenderPassDescClearValues<C> for GraphicsPipeline<Mv, L, Rp> where     Rp: RenderPassDescClearValues<C>,

fn convert_clear_values(&self, vals: C) -> Box<Iterator<Item = ClearValue>>

Decodes a C into a list of clear values where each element corresponds to an attachment. The size of the returned iterator must be the same as the number of attachments.

impl<Mv, L, Rp> VulkanObject for GraphicsPipeline<Mv, L, Rp>

type Object = Pipeline

The type of the object.

const TYPE: DebugReportObjectTypeEXT

TYPE: DebugReportObjectTypeEXT = vk::DEBUG_REPORT_OBJECT_TYPE_PIPELINE_EXT

The DebugReportObjectTypeEXT of the internal Vulkan handle.

fn internal_object(&self) -> Pipeline

Returns a reference to the object.

impl<Mv, L, Rp> GraphicsPipelineAbstract for GraphicsPipeline<Mv, L, Rp> where     L: PipelineLayoutAbstract,     Rp: RenderPassAbstract,     Mv: VertexSource<Vec<Arc<BufferAccess + Send + Sync>>>,

fn inner(&self) -> GraphicsPipelineSys

Returns an opaque object that represents the inside of the graphics pipeline.

fn subpass_index(&self) -> u32

Returns the index of the subpass this graphics pipeline is rendering to.

fn has_dynamic_line_width(&self) -> bool

Returns true if the line width used by this pipeline is dynamic.

fn num_viewports(&self) -> u32

Returns the number of viewports and scissors of this pipeline.

fn has_dynamic_viewports(&self) -> bool

Returns true if the viewports used by this pipeline are dynamic.

fn has_dynamic_scissors(&self) -> bool

Returns true if the scissors used by this pipeline are dynamic.

fn has_dynamic_depth_bounds(&self) -> bool

Returns true if the depth bounds used by this pipeline are dynamic.

fn has_dynamic_stencil_compare_mask(&self) -> bool

Returns true if the stencil compare masks used by this pipeline are dynamic.

fn has_dynamic_stencil_write_mask(&self) -> bool

Returns true if the stencil write masks used by this pipeline are dynamic.

fn has_dynamic_stencil_reference(&self) -> bool

Returns true if the stencil references used by this pipeline are dynamic.

fn subpass(self) -> Subpass<Self> where     Self: Sized,

Returns the subpass this graphics pipeline is rendering to.

impl<Mv, L, Rp, I> VertexDefinition<I> for GraphicsPipeline<Mv, L, Rp> where     Mv: VertexDefinition<I>,

type BuffersIter = <Mv as VertexDefinition<I>>::BuffersIter

Iterator that returns the offset, the stride (in bytes) and input rate of each buffer.

type AttribsIter = <Mv as VertexDefinition<I>>::AttribsIter

Iterator that returns the attribute location, buffer id, and infos.

fn definition(     &self,     interface: &I ) -> Result<(Self::BuffersIter, Self::AttribsIter), IncompatibleVertexDefinitionError>

Builds the vertex definition to use to link this definition to a vertex shader's input interface.

impl<Mv, L, Rp, S> VertexSource<S> for GraphicsPipeline<Mv, L, Rp> where     Mv: VertexSource<S>,

fn decode(&self, s: S) -> (Vec<Box<BufferAccess + Send + Sync>>, usize, usize)

Checks and returns the list of buffers with offsets, number of vertices and number of instances.