X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=include%2Fvlc_vout_window.h;h=b3db0818fc61522acb2e02bb28d4b5fe1f517d24;hb=03609aedd3bf7809923406804d5e9ed3f4d91b97;hp=0500a5f32f89bae33a4cfe60d59ce742234b387e;hpb=a82db287f874c9909ff221b1c30c7ed6655ad649;p=vlc diff --git a/include/vlc_vout_window.h b/include/vlc_vout_window.h index 0500a5f32f..b3db0818fc 100644 --- a/include/vlc_vout_window.h +++ b/include/vlc_vout_window.h @@ -41,7 +41,7 @@ typedef struct vout_window_sys_t vout_window_sys_t; * Window handle type */ enum { - VOUT_WINDOW_TYPE_XWINDOW, + VOUT_WINDOW_TYPE_XID, VOUT_WINDOW_TYPE_HWND, }; @@ -50,7 +50,8 @@ enum { */ enum { VOUT_WINDOW_SET_ON_TOP, /* int b_on_top */ - VOUT_WINDOW_SET_SIZE, /* int i_width, int i_height */ + VOUT_WINDOW_SET_SIZE, /* unsigned i_width, unsigned i_height */ + VOUT_WINDOW_SET_FULLSCREEN, /* int b_fullscreen */ }; typedef struct { @@ -64,9 +65,9 @@ typedef struct { int x; int y; - /* Windows size int */ - int width; - int height; + /* Windows size hint */ + unsigned width; + unsigned height; } vout_window_cfg_t; @@ -96,13 +97,13 @@ struct vout_window_t { /* Control on the module (mandatory) * - * Do not use it directly but use vout_window_Control. + * Do not use it directly; use vout_window_Control instead. */ int (*control)(vout_window_t *, int query, va_list); /* Private place holder for the vout_window_t module (optional) * - * A module is free to used it as it wishes. + * A module is free to use it as it wishes. */ vout_window_sys_t *sys; }; @@ -110,23 +111,23 @@ struct vout_window_t { /** * It creates a new window. * - * XXX If you are inside a "vout display", you must use + * @note If you are inside a "vout display", you must use * vout_display_New/DeleteWindow when possible to allow window recycling. */ VLC_EXPORT( vout_window_t *, vout_window_New, (vlc_object_t *, const char *module, const vout_window_cfg_t *) ); /** - * It deletes a window created by vout_window_New. + * It deletes a window created by vout_window_New(). * - * XXX See vout_window_New about window recycling. + * @note See vout_window_New() about window recycling. */ VLC_EXPORT( void, vout_window_Delete, (vout_window_t *) ); /** * It allows configuring a window. * - * XXX you must own the windows, and vout_window_t are not thread safe. - * You must not use it directly but prefer the vout_window_* wrappers. + * @warning The caller must own the window, as vout_window_t is not thread safe. + * You should use it the vout_window_* wrappers instead of this function. */ VLC_EXPORT( int, vout_window_Control, (vout_window_t *, int query, ...) ); @@ -141,10 +142,19 @@ static inline int vout_window_SetOnTop(vout_window_t *window, bool is_on_top) /** * Configure the windows display size. */ -static inline int vout_window_SetSize(vout_window_t *window, int width, int height) +static inline int vout_window_SetSize(vout_window_t *window, + unsigned width, unsigned height) { return vout_window_Control(window, VOUT_WINDOW_SET_SIZE, width, height); } +/** + * Configure the windows fullscreen mode. + */ +static inline int vout_window_SetFullScreen(vout_window_t *window, bool full) +{ + return vout_window_Control(window, VOUT_WINDOW_SET_FULLSCREEN, full); +} + #endif /* VLC_VOUT_WINDOW_H */