Radeon ProRender

rprIESLightSetImageFromIESdata

Sets an image for an IES light from data in memory.

rpr_status rprIESLightSetImageFromIESdata( rpr_light env_light,
  rpr_char const * iesData,
  rpr_int nx,
  rpr_int ny);

Parameters

Parameter Description
env_light The environment light to set an image for.
iesData Image data string defining the IES light (null terminated string, IES format).
nx Resolution X of the IES image.
ny Resolution Y of the IES image.

Notes

IES files, composed of light quantities and measurements, specify intensity, falloff and radial dispersion of light, and are available for many real-world light sources.

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
  • RPR_ERROR_UNSUPPORTED_IMAGE_FORMAT (if the format of the IES file is not supported by AMD Radeon ProRender)