HdEmbreeRenderer Class Reference

HdEmbreeRenderer implements a renderer on top of Embree's raycasting abilities. More...

Public Member Functions
	HdEmbreeRenderer ()
	Renderer constructor. More...
	~HdEmbreeRenderer ()
	Renderer destructor. More...
void	SetScene (RTCScene scene)
	Set the embree scene that this renderer should raycast into. More...
void	SetDataWindow (const GfRect2i &dataWindow)
	Set the data window to fill (same meaning as in CameraUtilFraming with coordinate system also being y-Down). More...
void	SetCamera (const GfMatrix4d &viewMatrix, const GfMatrix4d &projMatrix)
	Set the camera to use for rendering. More...
void	SetAovBindings (HdRenderPassAovBindingVector const &aovBindings)
	Set the aov bindings to use for rendering. More...
HdRenderPassAovBindingVector const &	GetAovBindings () const
	Get the aov bindings being used for rendering. More...
void	SetSamplesToConvergence (int samplesToConvergence)
	Set how many samples to render before considering an image converged. More...
void	SetAmbientOcclusionSamples (int ambientOcclusionSamples)
	Set how many samples to use for ambient occlusion. More...
void	SetEnableSceneColors (bool enableSceneColors)
	Sets whether to use scene colors while rendering. More...
void	Render (HdRenderThread *renderThread)
	Rendering entrypoint: add one sample per pixel to the whole sample buffer, and then loop until the image is converged. More...
void	Clear ()
	Clear the bound aov buffers (typically before rendering). More...
void	MarkAovBuffersUnconverged ()
	Mark the aov buffers as unconverged. More...
int	GetCompletedSamples () const
	Get the number of samples completed so far. More...

Detailed Description

HdEmbreeRenderer implements a renderer on top of Embree's raycasting abilities.

This is currently a very simple renderer. It breaks the framebuffer into tiles for multithreading; sends out jittered camera rays; and implements the following shading:

• Colors via the "color" primvar.
• Lighting via N dot Camera-ray, simulating a point light at the camera origin.
• Ambient occlusion.

Definition at line 54 of file renderer.h.

Constructor & Destructor Documentation

HdEmbreeRenderer()

HdEmbreeRenderer

(

)

Renderer constructor.

~HdEmbreeRenderer()

~HdEmbreeRenderer

(

)

Renderer destructor.

Member Function Documentation

Clear()

void Clear

(

)

Clear the bound aov buffers (typically before rendering).

GetAovBindings()

HdRenderPassAovBindingVector const& GetAovBindings ( ) const

inline

Get the aov bindings being used for rendering.

Returns

the current aov bindings.

Definition at line 82 of file renderer.h.

GetCompletedSamples()

int GetCompletedSamples

(

)

const

Get the number of samples completed so far.

MarkAovBuffersUnconverged()

void MarkAovBuffersUnconverged

(

)

Mark the aov buffers as unconverged.

Render()

void Render

(

HdRenderThread *

renderThread

)

Rendering entrypoint: add one sample per pixel to the whole sample buffer, and then loop until the image is converged.

After each pass, the image will be resolved into a color buffer.

Parameters

renderThread

A handle to the render thread, used for checking for cancellation and locking the color buffer.

SetAmbientOcclusionSamples()

void SetAmbientOcclusionSamples

(

int

ambientOcclusionSamples

)

Set how many samples to use for ambient occlusion.

Parameters

ambientOcclusionSamples

How many samples are needed for ambient occlusion? 0 = disable.

SetAovBindings()

void SetAovBindings

(

HdRenderPassAovBindingVector const &

aovBindings

)

Set the aov bindings to use for rendering.

Parameters

aovBindings

A list of aov bindings.

SetCamera()

void SetCamera	(	const GfMatrix4d &	viewMatrix,
		const GfMatrix4d &	projMatrix
	)

Set the camera to use for rendering.

Parameters

viewMatrix	The camera's world-to-view matrix.
projMatrix	The camera's view-to-NDC projection matrix.

SetDataWindow()

void SetDataWindow

(

const GfRect2i &

dataWindow

)

Set the data window to fill (same meaning as in CameraUtilFraming with coordinate system also being y-Down).

SetEnableSceneColors()

void SetEnableSceneColors

(

bool

enableSceneColors

)

Sets whether to use scene colors while rendering.

Parameters

enableSceneColors

Whether drawing should sample color, or draw everything as white.

SetSamplesToConvergence()

void SetSamplesToConvergence

(

int

samplesToConvergence

)

Set how many samples to render before considering an image converged.

Parameters

samplesToConvergence

How many samples are needed, per-pixel, before the image is considered finished.

SetScene()

void SetScene

(

RTCScene

scene

)

Set the embree scene that this renderer should raycast into.

Parameters

scene

The embree scene to use.

---

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

• pxr/imaging/hdEmbree/renderer.h