0b902a69ed80ce63f0e483e965e31c36b5d2d85c
[vlc.git] / modules / video_output / x11 / xvideo.c
1 /*****************************************************************************
2  * xvideo.c : Xvideo plugin for vlc
3  *****************************************************************************
4  * Copyright (C) 1998-2001 the VideoLAN team
5  * $Id$
6  *
7  * Authors: Shane Harper <shanegh@optusnet.com.au>
8  *          Vincent Seguin <seguin@via.ecp.fr>
9  *          Samuel Hocevar <sam@zoy.org>
10  *          David Kennedy <dkennedy@tinytoad.com>
11  *
12  * This program is free software; you can redistribute it and/or modify
13  * it under the terms of the GNU General Public License as published by
14  * the Free Software Foundation; either version 2 of the License, or
15  * (at your option) any later version.
16  *
17  * This program is distributed in the hope that it will be useful,
18  * but WITHOUT ANY WARRANTY; without even the implied warranty of
19  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
20  * GNU General Public License for more details.
21  *
22  * You should have received a copy of the GNU General Public License
23  * along with this program; if not, write to the Free Software
24  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
25  *****************************************************************************/
26
27 /*****************************************************************************
28  * Preamble
29  *****************************************************************************/
30
31 #ifdef HAVE_CONFIG_H
32 # include "config.h"
33 #endif
34
35 #include <vlc_common.h>
36 #include <vlc_plugin.h>
37
38 /*****************************************************************************
39  * Exported prototypes
40  *****************************************************************************/
41 extern int  Activate   ( vlc_object_t * );
42 extern void Deactivate ( vlc_object_t * );
43
44 /*****************************************************************************
45  * Module descriptor
46  *****************************************************************************/
47 #define ADAPTOR_TEXT N_("XVideo adaptor number")
48 #define ADAPTOR_LONGTEXT N_( \
49     "If your graphics card provides several adaptors, you need to choose " \
50     "which one will be used (you shouldn't have to change this).")
51
52 #define ALT_FS_TEXT N_("Alternate fullscreen method")
53 #define ALT_FS_LONGTEXT N_( \
54     "There are two ways to make a fullscreen window, unfortunately each one " \
55     "has its drawbacks.\n" \
56     "1) Let the window manager handle your fullscreen window (default), but " \
57     "things like taskbars will likely show on top of the video.\n" \
58     "2) Completely bypass the window manager, but then nothing will be able " \
59     "to show on top of the video.")
60
61 #define DISPLAY_TEXT N_("X11 display")
62 #define DISPLAY_LONGTEXT N_( \
63     "X11 hardware display to use. By default VLC will " \
64     "use the value of the DISPLAY environment variable.")
65
66 #define CHROMA_TEXT N_("XVimage chroma format")
67 #define CHROMA_LONGTEXT N_( \
68     "Force the XVideo renderer to use a specific chroma format instead of " \
69     "trying to improve performances by using the most efficient one.")
70
71 #define SHM_TEXT N_("Use shared memory")
72 #define SHM_LONGTEXT N_( \
73     "Use shared memory to communicate between VLC and the X server.")
74
75 vlc_module_begin ()
76     set_shortname( "XVideo" )
77     set_category( CAT_VIDEO )
78     set_subcategory( SUBCAT_VIDEO_VOUT )
79     add_string( "xvideo-display", NULL, NULL, DISPLAY_TEXT, DISPLAY_LONGTEXT, true )
80     add_integer( "xvideo-adaptor", -1, NULL, ADAPTOR_TEXT, ADAPTOR_LONGTEXT, true )
81     add_bool( "xvideo-altfullscreen", 0, NULL, ALT_FS_TEXT, ALT_FS_LONGTEXT, true )
82     add_string( "xvideo-chroma", NULL, NULL, CHROMA_TEXT, CHROMA_LONGTEXT, true )
83 #ifdef HAVE_SYS_SHM_H
84     add_bool( "xvideo-shm", 1, NULL, SHM_TEXT, SHM_LONGTEXT, true )
85 #endif
86
87     set_description( N_("XVideo extension video output") )
88     set_capability( "video output", 150 )
89     set_callbacks( Activate, Deactivate )
90 vlc_module_end ()
91
92 /* following functions are local */
93
94 #if 0
95 /*****************************************************************************
96  * XVideoSetAttribute
97  *****************************************************************************
98  * This function can be used to set attributes, e.g. XV_BRIGHTNESS and
99  * XV_CONTRAST. "f_value" should be in the range of 0 to 1.
100  *****************************************************************************/
101 static void XVideoSetAttribute( vout_thread_t *p_vout,
102                                 char *attr_name, float f_value )
103 {
104     int             i_attrib;
105     XvAttribute    *p_attrib;
106     Display        *p_display = p_vout->p_sys->p_display;
107     int             i_xvport  = p_vout->p_sys->i_xvport;
108
109     p_attrib = XvQueryPortAttributes( p_display, i_xvport, &i_attrib );
110
111     do
112     {
113         i_attrib--;
114
115         if( i_attrib >= 0 && !strcmp( p_attrib[ i_attrib ].name, attr_name ) )
116         {
117             int i_sv = f_value * ( p_attrib[ i_attrib ].max_value
118                                     - p_attrib[ i_attrib ].min_value + 1 )
119                         + p_attrib[ i_attrib ].min_value;
120
121             XvSetPortAttribute( p_display, i_xvport,
122                             XInternAtom( p_display, attr_name, False ), i_sv );
123             break;
124         }
125
126     } while( i_attrib > 0 );
127
128     if( p_attrib )
129         XFree( p_attrib );
130 }
131 #endif
132