[vlc-commits] opengl: clarify comments

[Zhao Zhili]

vlc | branch: master | Zhao Zhili  | Mon Apr 16 
20:13:51 2018 +0800| [0fafd8935cbe5c2d4f291d1d563f5adaa8c40659] | committer: 
Thomas Guillem

opengl: clarify comments

Signed-off-by: Thomas Guillem 

> http://git.videolan.org/gitweb.cgi/vlc.git/?a=commit;h=0fafd8935cbe5c2d4f291d1d563f5adaa8c40659
---

 modules/video_output/opengl/converter.h | 34 -
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/modules/video_output/opengl/converter.h 
b/modules/video_output/opengl/converter.h
index 470758e876..e7179fc8f9 100644
--- a/modules/video_output/opengl/converter.h
+++ b/modules/video_output/opengl/converter.h
@@ -341,7 +341,7 @@ struct opengl_tex_converter_t
 /* Private context */
 void *priv;
 
-/*
+/**
  * Callback to allocate data for bound textures
  *
  * This function pointer can be NULL. Software converters should call
@@ -349,7 +349,7 @@ struct opengl_tex_converter_t
  * caller when calling glDeleteTextures()). Won't be called if
  * handle_texs_gen is true.
  *
- * \param fc OpenGL tex converter
+ * \param tc OpenGL tex converter
  * \param textures array of textures to bind (one per plane)
  * \param tex_width array of tex width (one per plane)
  * \param tex_height array of tex height (one per plane)
@@ -358,26 +358,26 @@ struct opengl_tex_converter_t
 int (*pf_allocate_textures)(const opengl_tex_converter_t *tc, GLuint 
*textures,
 const GLsizei *tex_width, const GLsizei 
*tex_height);
 
-/*
+/**
  * Callback to allocate a picture pool
  *
  * This function pointer *can* be NULL. If NULL, A generic pool with
  * pictures allocated from the video_format_t will be used.
  *
- * \param fc OpenGL tex converter
+ * \param tc OpenGL tex converter
  * \param requested_count number of pictures to allocate
  * \return the picture pool or NULL in case of error
  */
-picture_pool_t *(*pf_get_pool)(const opengl_tex_converter_t *fc,
+picture_pool_t *(*pf_get_pool)(const opengl_tex_converter_t *tc,
unsigned requested_count);
 
-/*
+/**
  * Callback to update a picture
  *
  * This function pointer cannot be NULL. The implementation should upload
  * every planes of the picture.
  *
- * \param fc OpenGL tex converter
+ * \param tc OpenGL tex converter
  * \param textures array of textures to bind (one per plane)
  * \param tex_width array of tex width (one per plane)
  * \param tex_height array of tex height (one per plane)
@@ -386,39 +386,39 @@ struct opengl_tex_converter_t
  * (one per plane, can be NULL)
  * \return VLC_SUCCESS or a VLC error
  */
-int (*pf_update)(const opengl_tex_converter_t *fc, GLuint *textures,
+int (*pf_update)(const opengl_tex_converter_t *tc, GLuint *textures,
  const GLsizei *tex_width, const GLsizei *tex_height,
  picture_t *pic, const size_t *plane_offset);
 
-/*
+/**
  * Callback to fetch locations of uniform or attributes variables
  *
  * This function pointer cannot be NULL. This callback is called one time
  * after init.
  *
- * \param fc OpenGL tex converter
+ * \param tc OpenGL tex converter
  * \param program linked program that will be used by this tex converter
  * \return VLC_SUCCESS or a VLC error
  */
-int (*pf_fetch_locations)(opengl_tex_converter_t *fc, GLuint program);
+int (*pf_fetch_locations)(opengl_tex_converter_t *tc, GLuint program);
 
-/*
+/**
  * Callback to prepare the fragment shader
  *
  * This function pointer cannot be NULL. This callback can be used to
  * specify values of uniform variables.
  *
- * \param fc OpenGL tex converter
+ * \param tc OpenGL tex converter
  * \param tex_width array of tex width (one per plane)
  * \param tex_height array of tex height (one per plane)
  * \param alpha alpha value, used only for RGBA fragment shader
  */
-void (*pf_prepare_shader)(const opengl_tex_converter_t *fc,
+void (*pf_prepare_shader)(const opengl_tex_converter_t *tc,
   const GLsizei *tex_width, const GLsizei 
*tex_height,
   float alpha);
 };
 
-/*
+/**
  * Generate a fragment shader
  *
  * This utility function can be used by hw opengl tex converters that need a
@@ -430,8 +430,8 @@ struct opengl_tex_converter_t
  * \param tc OpenGL tex converter
  * \param tex_target GL_TEXTURE_2D or GL_TEXTURE_RECTANGLE
  * \param chroma chroma used to generate the fragment shader
- * \param if not COLOR_SPACE_UNDEF, YUV planes will be converted to RGB
- * according to the color space
+ * \param yuv_space if not COLOR_SPACE_UNDEF, YUV planes will be converted to
+ * RGB according to the color space
  * \return the 

[vlc-commits] opengl: clarify comments

[Zhao Zhili]

vlc | branch: master | Zhao Zhili  | Mon Apr 16 
20:13:51 2018 +0800| [a060f674757c55ac407d2488acb6a01ed707151c] | committer: 
Thomas Guillem

opengl: clarify comments

Signed-off-by: Thomas Guillem 

> http://git.videolan.org/gitweb.cgi/vlc.git/?a=commit;h=a060f674757c55ac407d2488acb6a01ed707151c
---

 modules/video_output/opengl/converter.h | 30 +++---
 1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/modules/video_output/opengl/converter.h 
b/modules/video_output/opengl/converter.h
index 470758e876..b1a18f7fdd 100644
--- a/modules/video_output/opengl/converter.h
+++ b/modules/video_output/opengl/converter.h
@@ -341,7 +341,7 @@ struct opengl_tex_converter_t
 /* Private context */
 void *priv;
 
-/*
+/**
  * Callback to allocate data for bound textures
  *
  * This function pointer can be NULL. Software converters should call
@@ -349,7 +349,7 @@ struct opengl_tex_converter_t
  * caller when calling glDeleteTextures()). Won't be called if
  * handle_texs_gen is true.
  *
- * \param fc OpenGL tex converter
+ * \param tc OpenGL tex converter
  * \param textures array of textures to bind (one per plane)
  * \param tex_width array of tex width (one per plane)
  * \param tex_height array of tex height (one per plane)
@@ -358,26 +358,26 @@ struct opengl_tex_converter_t
 int (*pf_allocate_textures)(const opengl_tex_converter_t *tc, GLuint 
*textures,
 const GLsizei *tex_width, const GLsizei 
*tex_height);
 
-/*
+/**
  * Callback to allocate a picture pool
  *
  * This function pointer *can* be NULL. If NULL, A generic pool with
  * pictures allocated from the video_format_t will be used.
  *
- * \param fc OpenGL tex converter
+ * \param tc OpenGL tex converter
  * \param requested_count number of pictures to allocate
  * \return the picture pool or NULL in case of error
  */
-picture_pool_t *(*pf_get_pool)(const opengl_tex_converter_t *fc,
+picture_pool_t *(*pf_get_pool)(const opengl_tex_converter_t *tc,
unsigned requested_count);
 
-/*
+/**
  * Callback to update a picture
  *
  * This function pointer cannot be NULL. The implementation should upload
  * every planes of the picture.
  *
- * \param fc OpenGL tex converter
+ * \param tc OpenGL tex converter
  * \param textures array of textures to bind (one per plane)
  * \param tex_width array of tex width (one per plane)
  * \param tex_height array of tex height (one per plane)
@@ -386,39 +386,39 @@ struct opengl_tex_converter_t
  * (one per plane, can be NULL)
  * \return VLC_SUCCESS or a VLC error
  */
-int (*pf_update)(const opengl_tex_converter_t *fc, GLuint *textures,
+int (*pf_update)(const opengl_tex_converter_t *tc, GLuint *textures,
  const GLsizei *tex_width, const GLsizei *tex_height,
  picture_t *pic, const size_t *plane_offset);
 
-/*
+/**
  * Callback to fetch locations of uniform or attributes variables
  *
  * This function pointer cannot be NULL. This callback is called one time
  * after init.
  *
- * \param fc OpenGL tex converter
+ * \param tc OpenGL tex converter
  * \param program linked program that will be used by this tex converter
  * \return VLC_SUCCESS or a VLC error
  */
-int (*pf_fetch_locations)(opengl_tex_converter_t *fc, GLuint program);
+int (*pf_fetch_locations)(opengl_tex_converter_t *tc, GLuint program);
 
-/*
+/**
  * Callback to prepare the fragment shader
  *
  * This function pointer cannot be NULL. This callback can be used to
  * specify values of uniform variables.
  *
- * \param fc OpenGL tex converter
+ * \param tc OpenGL tex converter
  * \param tex_width array of tex width (one per plane)
  * \param tex_height array of tex height (one per plane)
  * \param alpha alpha value, used only for RGBA fragment shader
  */
-void (*pf_prepare_shader)(const opengl_tex_converter_t *fc,
+void (*pf_prepare_shader)(const opengl_tex_converter_t *tc,
   const GLsizei *tex_width, const GLsizei 
*tex_height,
   float alpha);
 };
 
-/*
+/**
  * Generate a fragment shader
  *
  * This utility function can be used by hw opengl tex converters that need a

___
vlc-commits mailing list
vlc-commits@videolan.org
https://mailman.videolan.org/listinfo/vlc-commits