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.