Radeon ProRender

rifCommandQueueAttachImageFilterRect

Attaches the filter to command queue and sets the rectangle to be processed, input and output image objects of the filter.

rif_int rifCommandQueueAttachImageFilterRect( rif_command_queue command_queue,
  rif_image_filter image_filter,
  rif_image input_image,
  rif_image output_image,
  rif_uint x,
  rif_uint y,
  rif_uint w,
  rif_uint h);

Parameters

Parameter Input/Output Description
command_queue input A valid command queue object.
image_filter input A valid image filter object.
input_image input A valid image object.
output_image input A valid image object.
x input X coordinate of the left most pixel of the rectangle to be processed. Must be a multiple of 8.
y input Y coordinate of the top most pixel of the rectangle to be processed. Must be a multiple of 8.
w input Width of the rectangle to be processed. Must be a multiple of 8.
h input Height of the rectangle to be processed. Must be a multiple of 8.

Return

Returns RIF_SUCCESS if the function is executed successfully, or RIF_ERROR code if a problem is encountered.

Errors

Possible error codes:

  • RIF_ERROR_INVALID_QUEUE - command_queue is not a valid command queue object.
  • RIF_ERROR_INVALID_FILTER - image_filter is not a valid image filter object.
  • RIF_ERROR_INVALID_IMAGE - input_image or output_image is not a valid image object.
  • RIF_ERROR_INTERNAL_ERROR - an internal RadeonImageFiflters error occurs. Send a bug report if such an error occurs.
  • RIF_ERROR_INVALID_PARAMETER - either x, y, w, or h is not a multiple of 8.