Skip to content
Snippets Groups Projects
Commit 7b8d3fc0 authored by Alexandre Janniaux's avatar Alexandre Janniaux Committed by Jean-Baptiste Kempf
Browse files

lib: media_player: fix doxygen

Doxygen for libvlc_video_output_cfg_t and libvlc_video_render_cfg_t
were not correct and led to the documentation of one field being
assigned to the field after it.

In the future, the fields might need more precision regarding the
possible ranges or kind of values they can convey, so use a top
comment instead of a sibling one, which can more easily integrate
a brief and a longer explanation.
parent 804e8522
No related branches found
No related tags found
1 merge request!1384lib: media_player: fix doxygen
Pipeline #190868 passed with stages
in 32 minutes and 36 seconds
......@@ -560,29 +560,46 @@ typedef void (*libvlc_video_output_cleanup_cb)(void* opaque);
typedef struct libvlc_video_render_cfg_t
{
unsigned width; /** rendering video width in pixel */
unsigned height; /** rendering video height in pixel */
unsigned bitdepth; /** rendering video bit depth in bits per channel */
bool full_range; /** video is full range or studio/limited range */
libvlc_video_color_space_t colorspace; /** video color space */
libvlc_video_color_primaries_t primaries; /** video color primaries */
libvlc_video_transfer_func_t transfer; /** video transfer function */
void *device; /** device used for rendering, IDirect3DDevice9* for D3D9 */
/** rendering video width in pixel */
unsigned width;
/** rendering video height in pixel */
unsigned height;
/** rendering video bit depth in bits per channel */
unsigned bitdepth;
/** video is full range or studio/limited range */
bool full_range;
/** video color space */
libvlc_video_color_space_t colorspace;
/** video color primaries */
libvlc_video_color_primaries_t primaries;
/** video transfer function */
libvlc_video_transfer_func_t transfer;
/** device used for rendering, IDirect3DDevice9* for D3D9 */
void *device;
} libvlc_video_render_cfg_t;
typedef struct libvlc_video_output_cfg_t
{
union {
int dxgi_format; /** the rendering DXGI_FORMAT for \ref libvlc_video_engine_d3d11*/
uint32_t d3d9_format; /** the rendering D3DFORMAT for \ref libvlc_video_engine_d3d9 */
int opengl_format; /** the rendering GLint GL_RGBA or GL_RGB for \ref libvlc_video_engine_opengl and
for \ref libvlc_video_engine_gles2 */
void *p_surface; /** currently unused */
/** The rendering DXGI_FORMAT for \ref libvlc_video_engine_d3d11. */
int dxgi_format;
/** The rendering D3DFORMAT for \ref libvlc_video_engine_d3d9. */
uint32_t d3d9_format;
/** The rendering GLint GL_RGBA or GL_RGB for
* \ref libvlc_video_engine_opengl and for
* \ref libvlc_video_engine_gles2. */
int opengl_format;
/** currently unused */
void *p_surface;
};
bool full_range; /** video is full range or studio/limited range */
libvlc_video_color_space_t colorspace; /** video color space */
libvlc_video_color_primaries_t primaries; /** video color primaries */
libvlc_video_transfer_func_t transfer; /** video transfer function */
/** Video is full range or studio/limited range. */
bool full_range;
/** video color space */
libvlc_video_color_space_t colorspace;
/** video color primaries */
libvlc_video_color_primaries_t primaries;
/** video transfer function */
libvlc_video_transfer_func_t transfer;
} libvlc_video_output_cfg_t;
/**
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment