Commit 57d77b39 authored by Stefano Sabatini's avatar Stefano Sabatini

lavu/opencl: apply misc cosmetics fixes

Split long lines, reindent code, add missing spaces between operators,
remove possibly confusing comment from av_opencl_buffer_read_image()
doxy, and use designated initializers for openclutils_class.
parent 4394528d
This diff is collapsed.
...@@ -67,7 +67,8 @@ AVOpenCLExternalEnv *av_opencl_alloc_external_env(void); ...@@ -67,7 +67,8 @@ AVOpenCLExternalEnv *av_opencl_alloc_external_env(void);
/** /**
* Free OpenCL external environment. * Free OpenCL external environment.
* *
* @param ext_opencl_env pointer to OpenCL external environment created by av_opencl_alloc_external_env() * @param ext_opencl_env pointer to OpenCL external environment
* created by av_opencl_alloc_external_env()
*/ */
void av_opencl_free_external_env(AVOpenCLExternalEnv **ext_opencl_env); void av_opencl_free_external_env(AVOpenCLExternalEnv **ext_opencl_env);
...@@ -83,8 +84,8 @@ void av_opencl_free_external_env(AVOpenCLExternalEnv **ext_opencl_env); ...@@ -83,8 +84,8 @@ void av_opencl_free_external_env(AVOpenCLExternalEnv **ext_opencl_env);
int av_opencl_register_kernel_code(const char *kernel_code); int av_opencl_register_kernel_code(const char *kernel_code);
/** /**
* Initialize the run time OpenCL environment and compile the kernel code registered with * Initialize the run time OpenCL environment and compile the kernel
* av_opencl_register_kernel_code(). * code registered with av_opencl_register_kernel_code().
* *
* Currently, the only accepted option is "build_options", used to set * Currently, the only accepted option is "build_options", used to set
* options to compile registered kernels code. See reference "OpenCL * options to compile registered kernels code. See reference "OpenCL
...@@ -100,8 +101,8 @@ int av_opencl_register_kernel_code(const char *kernel_code); ...@@ -100,8 +101,8 @@ int av_opencl_register_kernel_code(const char *kernel_code);
/** /**
* Create kernel object in the specified kernel environment. * Create kernel object in the specified kernel environment.
* *
* @param env pointer to kernel environment which is filled with the environment, * @param env pointer to kernel environment which is filled with
* used to run the kernel * the environment used to run the kernel
* @param kernel_name kernel function name * @param kernel_name kernel function name
* @return >=0 on success, a negative error code in case of failure * @return >=0 on success, a negative error code in case of failure
*/ */
...@@ -160,11 +161,10 @@ int av_opencl_buffer_read(uint8_t *dst_buf, cl_mem src_cl_buf, size_t buf_size); ...@@ -160,11 +161,10 @@ int av_opencl_buffer_read(uint8_t *dst_buf, cl_mem src_cl_buf, size_t buf_size);
*/ */
int av_opencl_buffer_write_image(cl_mem dst_cl_buf, size_t cl_buffer_size, int dst_cl_offset, int av_opencl_buffer_write_image(cl_mem dst_cl_buf, size_t cl_buffer_size, int dst_cl_offset,
uint8_t **src_data, int *plane_size, int plane_num); uint8_t **src_data, int *plane_size, int plane_num);
/** /**
* Read image data from OpenCL buffer. * Read image data from OpenCL buffer.
* *
* src buffer is OpenCL buffer, dst buffer is frame buffer(data[0],data[1]....).
*
* @param dst_data array of pointers to destination plane buffers * @param dst_data array of pointers to destination plane buffers
* @param dst_plane_sizes array of pointers to destination plane buffers * @param dst_plane_sizes array of pointers to destination plane buffers
* @param dst_plane_num number of destination image planes * @param dst_plane_num number of destination image planes
...@@ -172,20 +172,22 @@ int av_opencl_buffer_write_image(cl_mem dst_cl_buf, size_t cl_buffer_size, int d ...@@ -172,20 +172,22 @@ int av_opencl_buffer_write_image(cl_mem dst_cl_buf, size_t cl_buffer_size, int d
* @param src_cl_buf_size size in bytes of OpenCL buffer * @param src_cl_buf_size size in bytes of OpenCL buffer
* @return >=0 on success, a negative error code in case of failure * @return >=0 on success, a negative error code in case of failure
*/ */
int av_opencl_buffer_read_image(uint8_t **dst_data, int *plane_size, int plane_num, int av_opencl_buffer_read_image(uint8_t **dst_data, int *plane_size, int plane_num,
cl_mem src_cl_buf, size_t cl_buffer_size); cl_mem src_cl_buf, size_t cl_buffer_size);
/** /**
* Release OpenCL buffer. * Release OpenCL buffer.
* *
* @param cl_buf pointer to OpenCL buffer to release, which was previously filled with av_opencl_buffer_create() * @param cl_buf pointer to OpenCL buffer to release, which was
* previously filled with av_opencl_buffer_create()
*/ */
void av_opencl_buffer_release(cl_mem *cl_buf); void av_opencl_buffer_release(cl_mem *cl_buf);
/** /**
* Release kernel object. * Release kernel object.
* *
* @param env kernel environment where the kernel object was created with av_opencl_create_kernel * @param env kernel environment where the kernel object was created
* with av_opencl_create_kernel()
*/ */
void av_opencl_release_kernel(AVOpenCLKernelEnv *env); void av_opencl_release_kernel(AVOpenCLKernelEnv *env);
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment