rprContextRender

Renders the final image.

rpr_status rprContextRender(

rpr_context context);

Parameters

Parameter

Description

context

The context to be rendered.

Notes

Perform evaluation and accumulation of a single sample (or number of samples if iterations are set).

The call is blocking and the image is ready when returned. The context accumulates the samples in order to progressively refine the image and enable interactive response. So each new call to Render refines the result in image with +1 (or number of iterations) color samples. Call rprFrameBufferClear() if you want to start rendering new image instead of refining the previous one.

If you have the RPR_ERROR_MATERIAL_STACK_OVERFLOW error, you have created a shader graph with too many nodes. You can check the nodes limit with rprContextGetInfo (RPR_CONTEXT_MATERIAL_STACK_SIZE).

Return

Returns RPR_SUCCESS in case of success, or RPR_ERROR code if a problem was encountered.

To learn how to handle errors in AMD Radeon ProRender SDK, see Error Handling.

Errors

Possible error codes:

  • RPR_ERROR_OUT_OF_VIDEO_MEMORY

  • RPR_ERROR_OUT_OF_SYSTEM_MEMORY

  • RPR_ERROR_INTERNAL_ERROR

  • RPR_ERROR_MATERIAL_STACK_OVERFLOW