rprContextResolveFrameBuffer

Resolves a framebuffer.

Converts the input renderer’s native raw format src_frame_buffer into an output dst_frame_buffer that can be used for final rendering.

rpr_status rprContextResolveFrameBuffer(

rpr_context context,

rpr_framebuffer src_frame_buffer,

rpr_framebuffer dst_frame_buffer,

rpr_bool noDisplayGamma);

Parameters

Parameter

Description

context

Context used to resolve the frame buffer.

src_frame_buffer

Source framebuffer. src_frame_buffer and dst_frame_buffer should usually have the same dimension/format. src_frame_buffer is the result of a rprContextRender and should be attached to an AOV with rprContextSetAOV before the rprContextRender call. The post process that is applied to src_frame_buffer depends on the AOV it’s attached to. So it’s important to not modify its AOV (with rprContextSetAOV) between the rprContextRender and rprContextResolveFrameBuffer calls.

dst_frame_buffer

Destination framebuffer. dst_frame_buffer should not be attached to any AOV.

noDisplayGamma

If noDisplayGamma = FALSE, then RPR_CONTEXT_DISPLAY_GAMMA is applied to the dst_frame_buffer otherwise, display gamma is not used. It’s recommended to set it to FALSE for AOVs representing colors (like RPR_AOV_COLOR) and use TRUE for other AOVs.

Notes

  • In RPR API 1.310, the default value of normalizeOnly has been removed. Set it to FALSE, if you don’t use this argument.

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_SYSTEM_MEMORY

  • RPR_ERROR_OUT_OF_VIDEO_MEMORY