Struct screen_13::graph::Resolver

pub struct Resolver { /* private fields */ }

A structure which can read and execute render graphs. This pattern was derived from:

http://themaister.net/blog/2017/08/15/render-graphs-and-vulkan-a-deep-dive/ https://github.com/EmbarkStudios/kajiya

Implementations

impl Resolver

pub fn is_resolved(&self) -> bool

Returns true when all recorded passes have been submitted to a driver command buffer.

A fully-resolved graph contains no additional work and may be discarded, although doing so will stall the GPU while the fences are waited on. It is preferrable to wait a few frame so that the fences will have already been signalled.

pub fn node_pipeline_stages(&self, node: impl Node) -> PipelineStageFlags

Returns the stages that process the given node.

Note that this value must be retrieved before resolving a node as there will be no data left to inspect afterwards!

pub fn record_node_dependencies<P>( &mut self, pool: &mut P, cmd_buf: &mut CommandBuffer, node: impl Node ) -> Result<(), DriverError>

where P: Pool<DescriptorPoolInfo, DescriptorPool> + Pool<RenderPassInfo, RenderPass>,

Records any pending render graph passes that are required by the given node, but does not record any passes that actually contain the given node.

As a side effect, the graph is optimized for the given node. Future calls may further optimize the graph, but only on top of the existing optimizations. This only matters if you are pulling multiple images out and you care - in that case pull the “most important” image first.

pub fn record_node<P>( &mut self, pool: &mut P, cmd_buf: &mut CommandBuffer, node: impl Node ) -> Result<(), DriverError>

where P: Pool<DescriptorPoolInfo, DescriptorPool> + Pool<RenderPassInfo, RenderPass> + ?Sized,

Records any pending render graph passes that the given node requires.

pub fn record_unscheduled_passes<P>( &mut self, pool: &mut P, cmd_buf: &mut CommandBuffer ) -> Result<(), DriverError>

where P: Pool<DescriptorPoolInfo, DescriptorPool> + Pool<RenderPassInfo, RenderPass> + ?Sized,

Records any pending render graph passes that have not been previously scheduled.

pub fn submit<P>( self, pool: &mut P, queue_family_index: usize, queue_index: usize ) -> Result<Lease<CommandBuffer>, DriverError>

where P: Pool<CommandBufferInfo, CommandBuffer> + Pool<DescriptorPoolInfo, DescriptorPool> + Pool<RenderPassInfo, RenderPass>,

Submits the remaining commands stored in this instance.

Trait Implementations

impl Debug for Resolver

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

Formats the value using the given formatter.

impl Unbind<Resolver, SwapchainImage> for SwapchainImageNode

fn unbind(self, graph: &mut Resolver) -> SwapchainImage

Unbinds the resource from a graph-like object.