Struct PipelineRegistry

pub struct PipelineRegistry { /* private fields */ }

Registry for managing and dispatching drawable pipelines.

The PipelineRegistry serves as the central hub for all rendering pipelines in the Tessera framework. It maintains a collection of registered pipelines and handles the dispatch of draw commands to their appropriate pipelines.

Architecture

The registry uses type erasure to store pipelines of different types in a single collection. When a draw command needs to be rendered, the registry iterates through all registered pipelines until it finds one that can handle the command type.

Usage Pattern

1. Create a new registry
2. Register all required pipelines during application initialization
3. The renderer uses the registry to dispatch commands during frame rendering

Example

use tessera_ui::renderer::drawer::PipelineRegistry;

// Create registry and register pipelines
let mut registry = PipelineRegistry::new();
registry.register(my_shape_pipeline);
registry.register(my_text_pipeline);
registry.register(my_image_pipeline);

// Registry is now ready for use by the renderer

Performance Considerations

• Pipeline lookup is O(n) where n is the number of registered pipelines
• Register frequently used pipelines first for better average performance
• Consider the order of registration based on command frequency

Implementations

impl PipelineRegistry

pub fn new() -> Self

Creates a new empty pipeline registry.

Example

use tessera_ui::renderer::drawer::PipelineRegistry;

let registry = PipelineRegistry::new();

pub fn register<T: DrawCommand + 'static, P: DrawablePipeline<T> + 'static>( &mut self, pipeline: P, )

Registers a new drawable pipeline for a specific command type.

This method takes ownership of the pipeline and wraps it in a type-erased container that can be stored alongside other pipelines of different types.

Type Parameters

• T - The DrawCommand type this pipeline handles
• P - The pipeline implementation type

Parameters

• pipeline - The pipeline instance to register

Panics

This method does not panic, but the registry will panic during dispatch if no pipeline is found for a given command type.

Example

use tessera_ui::renderer::drawer::PipelineRegistry;

let mut registry = PipelineRegistry::new();

// Register a custom pipeline
let my_pipeline = MyCustomPipeline::new(&device, &config, sample_count);
registry.register(my_pipeline);

// Register multiple pipelines
registry.register(ShapePipeline::new(&device, &config, sample_count));
registry.register(TextPipeline::new(&device, &config, sample_count));

Registration Order

The order of registration can affect performance since pipeline lookup is performed linearly. Consider registering more frequently used pipelines first.

Trait Implementations

impl Default for PipelineRegistry

fn default() -> Self

Returns the “default value” for a type.