rprCameraSetApertureBlades

Sets the number of aperture blades for a camera.

The more blades used, the rounder the aperture hole with resultant differences in the handling of light, particularly light from point light sources. The most important case is bokeh shape while rendering shallow depth-of-field images.

rpr_status rprCameraSetApertureBlades(

rpr_camera camera,

rpr_uint num_blades);

Parameters

Parameter

Description

camera

The camera to set the number of aperture blades for.

num_blades

The desired number of blades. Maximum value is 32. Minimum value is 3.

Notes

This will only have an effect if DOF is enabled.

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_INVALID_PARAMETER