HdxRenderTask Class Reference

A task for rendering geometry to pixels. More...

+ Inheritance diagram for HdxRenderTask:

Public Member Functions

HDX_API HdxRenderTask (HdSceneDelegate *delegate, SdfPath const &id)
HDX_API bool IsConverged () const override
 Hooks for progressive rendering (delegated to renderpasses). More...
HDX_API void Prepare (HdTaskContext *ctx, HdRenderIndex *renderIndex) override
 Prepare the tasks resources. More...
HDX_API void Execute (HdTaskContext *ctx) override
 Execute render pass task. More...
HDX_API const TfTokenVectorGetRenderTags () const override
 Collect Render Tags used by the task. More...
- Public Member Functions inherited from HdxTask
HDX_API HdxTask (SdfPath const &id)
HDX_API void Sync (HdSceneDelegate *delegate, HdTaskContext *ctx, HdDirtyBits *dirtyBits) override final
 We override HdTask::Sync, but make it 'final' to make sure derived classes can't override it and instead override _Sync. More...

Protected Member Functions

HDX_API void _Sync (HdSceneDelegate *delegate, HdTaskContext *ctx, HdDirtyBits *dirtyBits) override
 Sync the render pass resources. More...
HDX_API HdRenderPassStateSharedPtr _GetRenderPassState (HdTaskContext *ctx) const
HDX_API bool _HasDrawItems () const
- Protected Member Functions inherited from HdxTask
HDX_API void _ToggleRenderTarget (HdTaskContext *ctx)
HDX_API Hgi_GetHgi () const

Detailed Description

A task for rendering geometry to pixels.

Rendering state management can be handled two ways: 1.) An application can create an HdxRenderTask and pass it the HdxRenderTaskParams struct as "params". 2.) An application can create an HdxRenderSetupTask and an HdxRenderTask, and pass params to the setup task. In this case the setup task must run first.

Parameter unpacking is handled by HdxRenderSetupTask; in case #1, HdxRenderTask creates a dummy setup task internally to manage the sync process.

Case #2 introduces complexity; the benefit is that by changing which setup task you run before the render task, you can change the render parameters without incurring a hydra sync or rebuilding any resources.

Definition at line 64 of file renderTask.h.

Member Function Documentation

◆ _Sync()

HDX_API void _Sync ( HdSceneDelegate delegate,
HdTaskContext *  ctx,
HdDirtyBits *  dirtyBits 

Sync the render pass resources.

Implements HdxTask.

◆ Execute()

HDX_API void Execute ( HdTaskContext *  ctx)

Execute render pass task.

◆ GetRenderTags()

HDX_API const TfTokenVector& GetRenderTags ( ) const

Collect Render Tags used by the task.

◆ IsConverged()

HDX_API bool IsConverged ( ) const

Hooks for progressive rendering (delegated to renderpasses).

Reimplemented from HdxTask.

◆ Prepare()

HDX_API void Prepare ( HdTaskContext *  ctx,
HdRenderIndex renderIndex 

Prepare the tasks resources.

The documentation for this class was generated from the following file: