git.sesse.net Git - vlc/blob - include/vlc_vout_window.h

   1 /*****************************************************************************
   2  * vlc_vout_window.h: vout_window_t definitions
   3  *****************************************************************************
   4  * Copyright (C) 2008 Rémi Denis-Courmont
   5  * Copyright (C) 2009 Laurent Aimar
   6  * $Id$
   7  *
   8  * Authors: Laurent Aimar <fenrir _AT_ videolan _DOT_ org>
   9  *
  10  * This program is free software; you can redistribute it and/or modify it
  11  * under the terms of the GNU Lesser General Public License as published by
  12  * the Free Software Foundation; either version 2.1 of the License, or
  13  * (at your option) any later version.
  14  *
  15  * This program is distributed in the hope that it will be useful,
  16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  18  * GNU Lesser General Public License for more details.
  19  *
  20  * You should have received a copy of the GNU Lesser General Public License
  21  * along with this program; if not, write to the Free Software Foundation,
  22  * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  23  *****************************************************************************/
  24
  25 #ifndef VLC_VOUT_WINDOW_H
  26 #define VLC_VOUT_WINDOW_H 1
  27
  28 /**
  29  * \file
  30  * This file defines vout windows structures and functions in vlc
  31  */
  32
  33 #include <stdarg.h>
  34 #include <vlc_common.h>
  35
  36 /* */
  37 typedef struct vout_window_t vout_window_t;
  38 typedef struct vout_window_sys_t vout_window_sys_t;
  39
  40 struct wl_display;
  41 struct wl_surface;
  42
  43 /**
  44  * Window handle type
  45  */
  46 enum {
  47     VOUT_WINDOW_TYPE_INVALID=0,
  48     VOUT_WINDOW_TYPE_XID,
  49     VOUT_WINDOW_TYPE_HWND,
  50     VOUT_WINDOW_TYPE_NSOBJECT,
  51     VOUT_WINDOW_TYPE_ANDROID_NATIVE,
  52     VOUT_WINDOW_TYPE_WAYLAND,
  53 };
  54
  55 /**
  56  * Control query for vout_window_t
  57  */
  58 enum {
  59     VOUT_WINDOW_SET_STATE, /* unsigned state */
  60     VOUT_WINDOW_SET_SIZE,   /* unsigned i_width, unsigned i_height */
  61     VOUT_WINDOW_SET_FULLSCREEN, /* int b_fullscreen */
  62 };
  63
  64 typedef struct {
  65     /* If true, a standalone window is requested */
  66     bool is_standalone;
  67
  68     /* Window handle type */
  69     unsigned type;
  70
  71     /* Window position hint */
  72     int x;
  73     int y;
  74
  75     /* Windows size hint */
  76     unsigned width;
  77     unsigned height;
  78
  79 } vout_window_cfg_t;
  80
  81 /**
  82  * FIXME do we need an event system in the window too ?
  83  * or the window user will take care of it ?
  84  */
  85 struct vout_window_t {
  86     VLC_COMMON_MEMBERS
  87
  88     unsigned type; /**< Window handle type */
  89
  90     /* window handle (mandatory)
  91      *
  92      * It must be filled in the open function.
  93      */
  94     union {
  95         void     *hwnd;          /* Win32 window handle */
  96         uint32_t xid;            /* X11 windows ID */
  97         void     *nsobject;      /* Mac OSX view object */
  98         void     *anativewindow; /* Android native window. */
  99         struct wl_surface *wl;   /* Wayland surface */
 100     } handle;
 101
 102     /* display server (mandatory) */
 103     union {
 104         char     *x11; /* X11 display (NULL = use default) */
 105         struct wl_display *wl;   /* Wayland struct wl_display pointer */
 106     } display;
 107
 108     /* Control on the module (mandatory)
 109      *
 110      * Do not use it directly; use vout_window_Control instead.
 111      */
 112     int (*control)(vout_window_t *, int query, va_list);
 113
 114     /* Private place holder for the vout_window_t module (optional)
 115      *
 116      * A module is free to use it as it wishes.
 117      */
 118     vout_window_sys_t *sys;
 119 };
 120
 121 /**
 122  * Creates a new window.
 123  *
 124  * @param module plugin name (usually "$window")
 125  * @note If you are inside a "vout display", you must use
 126  / vout_display_NewWindow() and vout_display_DeleteWindow() instead.
 127  * This enables recycling windows.
 128  */
 129 VLC_API vout_window_t * vout_window_New(vlc_object_t *, const char *module, const vout_window_cfg_t *);
 130
 131 /**
 132  * Deletes a window created by vout_window_New().
 133  *
 134  * @note See vout_window_New() about window recycling.
 135  */
 136 VLC_API void vout_window_Delete(vout_window_t *);
 137
 138 static inline int vout_window_vaControl(vout_window_t *window, int query,
 139                                         va_list ap)
 140 {
 141     return window->control(window, query, ap);
 142 }
 143
 144 /**
 145  * Reconfigures a window.
 146  *
 147  * @note The vout_window_* wrappers should be used instead of this function.
 148  *
 149  * @warning The caller must own the window, as vout_window_t is not thread safe.
 150  */
 151 static inline int vout_window_Control(vout_window_t *window, int query, ...)
 152 {
 153     va_list ap;
 154     int ret;
 155
 156     va_start(ap, query);
 157     ret = vout_window_vaControl(window, query, ap);
 158     va_end(ap);
 159     return ret;
 160 }
 161
 162 /**
 163  * Configures the window manager state for this window.
 164  */
 165 static inline int vout_window_SetState(vout_window_t *window, unsigned state)
 166 {
 167     return vout_window_Control(window, VOUT_WINDOW_SET_STATE, state);
 168 }
 169
 170 /**
 171  * Configures the window display (i.e. inner/useful) size.
 172  */
 173 static inline int vout_window_SetSize(vout_window_t *window,
 174                                       unsigned width, unsigned height)
 175 {
 176     return vout_window_Control(window, VOUT_WINDOW_SET_SIZE, width, height);
 177 }
 178
 179 /**
 180  * Sets fullscreen mode.
 181  */
 182 static inline int vout_window_SetFullScreen(vout_window_t *window, bool full)
 183 {
 184     return vout_window_Control(window, VOUT_WINDOW_SET_FULLSCREEN, full);
 185 }
 186
 187 #endif /* VLC_VOUT_WINDOW_H */