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
8 * Authors: Laurent Aimar <fenrir _AT_ videolan _DOT_ org>
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
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 General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
23 *****************************************************************************/
25 #ifndef VLC_VOUT_WINDOW_H
26 #define VLC_VOUT_WINDOW_H 1
30 * This file defines vout windows structures and functions in vlc
33 #include <vlc_common.h>
36 typedef struct vout_window_t vout_window_t
;
37 typedef struct vout_window_sys_t vout_window_sys_t
;
45 VOUT_WINDOW_TYPE_HWND
,
46 VOUT_WINDOW_TYPE_NSOBJECT
,
50 * Control query for vout_window_t
53 VOUT_WINDOW_SET_STATE
, /* unsigned state */
54 VOUT_WINDOW_SET_SIZE
, /* unsigned i_width, unsigned i_height */
55 VOUT_WINDOW_SET_FULLSCREEN
, /* int b_fullscreen */
59 /* If true, a standalone window is requested */
62 /* Window handle type */
65 /* Window position hint */
69 /* Windows size hint */
76 * FIXME do we need an event system in the window too ?
77 * or the window user will take care of it ?
79 struct vout_window_t
{
82 /* Initial state (reserved).
83 * Once the open function is called, it will be set to NULL
85 const vout_window_cfg_t
*cfg
;
87 /* window handle (mandatory)
89 * It must be filled in the open function.
92 void *hwnd
; /* Win32 window handle */
93 uint32_t xid
; /* X11 windows ID */
94 void *nsobject
; /* Mac OSX view object */
97 /* display server (mandatory) */
99 char *x11
; /* X11 display (NULL = use default) */
102 /* Control on the module (mandatory)
104 * Do not use it directly; use vout_window_Control instead.
106 int (*control
)(vout_window_t
*, int query
, va_list);
108 /* Private place holder for the vout_window_t module (optional)
110 * A module is free to use it as it wishes.
112 vout_window_sys_t
*sys
;
116 * It creates a new window.
118 * @note If you are inside a "vout display", you must use
119 * vout_display_New/DeleteWindow when possible to allow window recycling.
121 VLC_EXPORT( vout_window_t
*, vout_window_New
, (vlc_object_t
*, const char *module
, const vout_window_cfg_t
*) );
124 * It deletes a window created by vout_window_New().
126 * @note See vout_window_New() about window recycling.
128 VLC_EXPORT( void, vout_window_Delete
, (vout_window_t
*) );
131 * It allows configuring a window.
133 * @warning The caller must own the window, as vout_window_t is not thread safe.
134 * You should use it the vout_window_* wrappers instead of this function.
136 VLC_EXPORT( int, vout_window_Control
, (vout_window_t
*, int query
, ...) );
139 * Configure the window management state of a windows.
141 static inline int vout_window_SetState(vout_window_t
*window
, unsigned state
)
143 return vout_window_Control(window
, VOUT_WINDOW_SET_STATE
, state
);
147 * Configure the windows display size.
149 static inline int vout_window_SetSize(vout_window_t
*window
,
150 unsigned width
, unsigned height
)
152 return vout_window_Control(window
, VOUT_WINDOW_SET_SIZE
, width
, height
);
156 * Configure the windows fullscreen mode.
158 static inline int vout_window_SetFullScreen(vout_window_t
*window
, bool full
)
160 return vout_window_Control(window
, VOUT_WINDOW_SET_FULLSCREEN
, full
);
163 #endif /* VLC_VOUT_WINDOW_H */