]> git.sesse.net Git - vlc/blob - modules/gui/qt4/components/complete_preferences.cpp
Qt4 - Preferences: Fix the help text behaviour from modules. Known also as the very...
[vlc] / modules / gui / qt4 / components / complete_preferences.cpp
1 /*****************************************************************************
2  * preferences.cpp : "Normal preferences"
3  ****************************************************************************
4  * Copyright (C) 2006-2007 the VideoLAN team
5  * $Id$
6  *
7  * Authors: ClĂ©ment Stenac <zorglub@videolan.org>
8  *
9  * This program is free software; you can redistribute it and/or modify
10  * it under the terms of the GNU General Public License as published by
11  * the Free Software Foundation; either version 2 of the License, or
12  * (at your option) any later version.
13  *
14  * This program is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17  * GNU General Public License for more details.
18  *
19  * You should have received a copy of the GNU General Public License
20  * along with this program; if not, write to the Free Software
21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
22  *****************************************************************************/
23
24 #include <QApplication>
25 #include <QLabel>
26 #include <QTreeWidget>
27 #include <QTreeWidgetItem>
28 #include <QVariant>
29 #include <QString>
30 #include <QFont>
31 #include <QGroupBox>
32 #include <QScrollArea>
33 #include <QVBoxLayout>
34 #include <QHBoxLayout>
35 #include <QGridLayout>
36 #include <QHeaderView>
37 #include <QPalette>
38 #include <QColor>
39
40 #include "components/complete_preferences.hpp"
41 #include "components/preferences_widgets.hpp"
42 #include "qt4.hpp"
43
44 #include <vlc_config_cat.h>
45 #include <vlc_intf_strings.h>
46 #include <assert.h>
47
48 #include "pixmaps/audio.xpm"
49 #include "pixmaps/video.xpm"
50 #include "pixmaps/type_net.xpm"
51 #include "pixmaps/type_playlist.xpm"
52 #include "pixmaps/advanced.xpm"
53 #include "pixmaps/codec.xpm"
54 #include "pixmaps/intf.xpm"
55
56 #define ITEM_HEIGHT 25
57
58 /*********************************************************************
59  * The Tree
60  *********************************************************************/
61 PrefsTree::PrefsTree( intf_thread_t *_p_intf, QWidget *_parent ) :
62                             QTreeWidget( _parent ), p_intf( _p_intf )
63 {
64     setColumnCount( 1 );
65     setAlternatingRowColors( true );
66     header()->hide();
67     setIconSize( QSize( ITEM_HEIGHT,ITEM_HEIGHT ) );
68     setTextElideMode( Qt::ElideNone );
69     setHorizontalScrollBarPolicy ( Qt::ScrollBarAlwaysOn );
70
71 #define BI( a,b) QIcon a##_icon = QIcon( QPixmap( b##_xpm ))
72     BI( audio, audio );
73     BI( video, video );
74     BI( input, codec );
75     BI( sout, type_net );
76     BI( advanced, advanced );
77     BI( playlist, type_playlist );
78     BI( interface, intf );
79 #undef BI
80
81     /* Build the tree for the main module */
82     const module_t *p_module = NULL;
83     vlc_list_t *p_list = vlc_list_find( p_intf, VLC_OBJECT_MODULE,
84                                         FIND_ANYWHERE );
85     if( !p_list ) return;
86     for( unsigned i = 0; p_module == NULL; i++ )
87     {
88         assert (i < (unsigned)p_list->i_count);
89
90         const module_t *p_main = (module_t *)p_list->p_values[i].p_object;
91         if( strcmp( p_main->psz_object_name, "main" ) == 0 )
92             p_module = p_main;
93     }
94
95     PrefsItemData *data = NULL;
96     QTreeWidgetItem *current_item = NULL;
97     for (size_t i = 0; i < p_module->confsize; i++)
98     {
99         const module_config_t *p_item = p_module->p_config + i;
100         char *psz_help;
101         QIcon icon;
102         switch( p_item->i_type )
103         {
104         case CONFIG_CATEGORY:
105             if( p_item->value.i == -1 ) break;
106             data = new PrefsItemData();
107             data->name = QString( qfu( config_CategoryNameGet
108                                            ( p_item->value.i ) ) );
109             psz_help = config_CategoryHelpGet( p_item->value.i );
110             if( psz_help )
111                 data->help = QString( qfu(psz_help) );
112             else
113                 data->help.clear();
114             data->i_type = TYPE_CATEGORY;
115             data->i_object_id = p_item->value.i;
116
117             switch( p_item->value.i )
118             {
119 #define CI(a,b) case a: icon = b##_icon;break
120             CI( CAT_AUDIO, audio );
121             CI( CAT_VIDEO, video );
122             CI( CAT_INPUT, input );
123             CI( CAT_SOUT, sout );
124             CI( CAT_ADVANCED, advanced );
125             CI( CAT_PLAYLIST, playlist );
126             CI( CAT_INTERFACE, interface );
127 #undef CI
128             }
129
130             current_item = new QTreeWidgetItem();
131             current_item->setText( 0, data->name );
132             current_item->setIcon( 0 , icon );
133             current_item->setSizeHint( 0, QSize( -1, ITEM_HEIGHT ) );
134             current_item->setData( 0, Qt::UserRole,
135                                    qVariantFromValue( data ) );
136             addTopLevelItem( current_item );
137             break;
138         case CONFIG_SUBCATEGORY:
139             if( p_item->value.i == -1 ) break;
140             if( data &&
141                 ( p_item->value.i == SUBCAT_VIDEO_GENERAL ||
142                   p_item->value.i == SUBCAT_ADVANCED_MISC ||
143                   p_item->value.i == SUBCAT_INPUT_GENERAL ||
144                   p_item->value.i == SUBCAT_INTERFACE_GENERAL ||
145                   p_item->value.i == SUBCAT_SOUT_GENERAL||
146                   p_item->value.i == SUBCAT_PLAYLIST_GENERAL||
147                   p_item->value.i == SUBCAT_AUDIO_GENERAL ) )
148             {
149                 // Data still contains the correct thing
150                 data->i_type = TYPE_CATSUBCAT;
151                 data->i_subcat_id = p_item->value.i;
152                 data->name = QString( qfu( config_CategoryNameGet(
153                                             p_item->value.i )) );
154                 psz_help = config_CategoryHelpGet( p_item->value.i );
155                 if( psz_help )
156                     data->help = QString( qfu(psz_help) );
157                 else
158                     data->help.clear();
159                 current_item->setData( 0, Qt::UserRole,
160                                        QVariant::fromValue( data ) );
161                 continue;
162             }
163             data = new PrefsItemData();
164             data->name = QString( qfu( config_CategoryNameGet(
165                                                         p_item->value.i)) );
166             psz_help = config_CategoryHelpGet( p_item->value.i );
167             if( psz_help )
168                 data->help = QString( qfu(psz_help) );
169             else
170                 data->help.clear();
171             data->i_type = TYPE_SUBCATEGORY;
172             data->i_object_id = p_item->value.i;
173
174             assert( current_item );
175
176             /* TODO : Choose the image */
177             QTreeWidgetItem *subcat_item = new QTreeWidgetItem();
178             subcat_item->setText( 0, data->name );
179             //item->setIcon( 0 , XXX );
180             subcat_item->setData( 0, Qt::UserRole,
181                                   qVariantFromValue(data) );
182             subcat_item->setSizeHint( 0, QSize( -1, ITEM_HEIGHT ) );
183             current_item->addChild( subcat_item );
184             break;
185         }
186     }
187
188     /* Build the tree of plugins */
189     for( int i_index = 0; i_index < p_list->i_count; i_index++ )
190     {
191         p_module = (module_t *)p_list->p_values[i_index].p_object;
192
193         // Main module excluded
194         if( !strcmp( p_module->psz_object_name, "main" ) ) continue;
195
196         /* Exclude submodules; they have no config options of their own */
197         if( p_module->b_submodule ) continue;
198
199         unsigned i_subcategory = 0, i_category = 0;
200         bool b_options = false;
201
202         for (size_t i = 0; i < p_module->confsize; i++)
203         {
204             const module_config_t *p_item = p_module->p_config + i;
205
206             if( p_item->i_type == CONFIG_CATEGORY )
207                 i_category = p_item->value.i;
208             else if( p_item->i_type == CONFIG_SUBCATEGORY )
209                 i_subcategory = p_item->value.i;
210
211             if( p_item->i_type & CONFIG_ITEM )
212                 b_options = true;
213
214             if( b_options && i_category && i_subcategory )
215                 break;
216         }
217         if( !b_options || i_category == 0 || i_subcategory == 0 ) continue;
218
219         // Locate the category item;
220         QTreeWidgetItem *subcat_item = NULL;
221         bool b_found = false;
222         for( int i_cat_index = 0 ; i_cat_index < topLevelItemCount();
223                                    i_cat_index++ )
224         {
225             QTreeWidgetItem *cat_item = topLevelItem( i_cat_index );
226             PrefsItemData *data = cat_item->data( 0, Qt::UserRole ).
227                                              value<PrefsItemData *>();
228             if( data->i_object_id == i_category )
229             {
230                 for( int i_sc_index = 0; i_sc_index < cat_item->childCount();
231                          i_sc_index++ )
232                 {
233                     subcat_item = cat_item->child( i_sc_index );
234                     PrefsItemData *sc_data = subcat_item->data(0, Qt::UserRole).
235                                                 value<PrefsItemData *>();
236                     if( sc_data && sc_data->i_object_id == i_subcategory )
237                     {
238                         b_found = true;
239                         break;
240                     }
241                 }
242                 if( !b_found )
243                 {
244                     subcat_item = cat_item;
245                     b_found = true;
246                 }
247                 break;
248             }
249         }
250         if( !b_found ) continue;
251
252         PrefsItemData *module_data = new PrefsItemData();
253         module_data->b_submodule = p_module->b_submodule;
254         module_data->i_type = TYPE_MODULE;
255         module_data->psz_name = strdup( p_module->psz_object_name );
256         module_data->i_object_id = p_module->b_submodule ?
257                          ((module_t *)p_module->p_parent)->i_object_id :
258                          p_module->i_object_id;
259         module_data->help.clear();
260         // TODO image
261         QTreeWidgetItem *module_item = new QTreeWidgetItem();
262         module_item->setText( 0, qfu( p_module->psz_shortname ?
263                       p_module->psz_shortname : p_module->psz_object_name) );
264         //item->setIcon( 0 , XXX );
265         module_item->setData( 0, Qt::UserRole,
266                               QVariant::fromValue( module_data) );
267         module_item->setSizeHint( 0, QSize( -1, ITEM_HEIGHT ) );
268         subcat_item->addChild( module_item );
269     }
270
271     /* We got everything, just sort a bit */
272     sortItems( 0, Qt::AscendingOrder );
273
274     vlc_list_release( p_list );
275 }
276
277 PrefsTree::~PrefsTree() {}
278
279 void PrefsTree::applyAll()
280 {
281     doAll( false );
282 }
283
284 void PrefsTree::cleanAll()
285 {
286     doAll( true );
287 }
288
289 void PrefsTree::doAll( bool doclean )
290 {
291     for( int i_cat_index = 0 ; i_cat_index < topLevelItemCount();
292              i_cat_index++ )
293     {
294         QTreeWidgetItem *cat_item = topLevelItem( i_cat_index );
295         for( int i_sc_index = 0; i_sc_index < cat_item->childCount();
296                  i_sc_index++ )
297         {
298             QTreeWidgetItem *sc_item = cat_item->child( i_sc_index );
299             for( int i_module = 0 ; i_module < sc_item->childCount();
300                      i_module++ )
301             {
302                 PrefsItemData *data = sc_item->child( i_module )->
303                                data( 0, Qt::UserRole).value<PrefsItemData *>();
304                 if( data->panel && doclean )
305                 {
306                     delete data->panel;
307                     data->panel = NULL;
308                 }
309                 else if( data->panel )
310                     data->panel->apply();
311             }
312             PrefsItemData *data = sc_item->data( 0, Qt::UserRole).
313                                             value<PrefsItemData *>();
314             if( data->panel && doclean )
315             {
316                 delete data->panel;
317                 data->panel = NULL;
318             }
319             else if( data->panel )
320                 data->panel->apply();
321         }
322         PrefsItemData *data = cat_item->data( 0, Qt::UserRole).
323                                             value<PrefsItemData *>();
324         if( data->panel && doclean )
325         {
326             delete data->panel;
327             data->panel = NULL;
328         }
329         else if( data->panel )
330             data->panel->apply();
331     }
332 }
333
334 /*********************************************************************
335  * The Panel
336  *********************************************************************/
337 PrefsPanel::PrefsPanel( QWidget *_parent ) : QWidget( _parent )
338 {}
339
340 PrefsPanel::PrefsPanel( intf_thread_t *_p_intf, QWidget *_parent,
341                         PrefsItemData * data ) :
342                         QWidget( _parent ), p_intf( _p_intf )
343 {
344     /* Find our module */
345     module_t *p_module = NULL;
346     if( data->i_type == TYPE_CATEGORY )
347         return;
348     else if( data->i_type == TYPE_MODULE )
349         p_module = (module_t *) vlc_object_get( p_intf, data->i_object_id );
350     else
351     {
352         p_module = config_FindModule( VLC_OBJECT(p_intf), "main" );
353         assert( p_module );
354         vlc_object_yield( p_module );
355     }
356
357     module_t *p_realmodule = p_module->b_submodule
358             ? (module_t *)(p_module->p_parent)
359             : p_module;
360
361     module_config_t *p_item = p_realmodule->p_config;
362     module_config_t *p_end = p_item + p_realmodule->confsize;
363
364     if( data->i_type == TYPE_SUBCATEGORY || data->i_type ==  TYPE_CATSUBCAT )
365     {
366         while (p_item < p_end)
367         {
368             if( p_item->i_type == CONFIG_SUBCATEGORY &&
369                             ( data->i_type == TYPE_SUBCATEGORY &&
370                               p_item->value.i == data->i_object_id ) ||
371                             ( data->i_type == TYPE_CATSUBCAT &&
372                               p_item->value.i == data->i_subcat_id ) )
373                 break;
374             p_item++;
375         }
376     }
377
378     global_layout = new QVBoxLayout();
379     global_layout->setMargin( 2 );
380     QString head;
381     QString help;
382
383     help = QString( data->help );
384
385     if( data->i_type == TYPE_SUBCATEGORY || data->i_type ==  TYPE_CATSUBCAT )
386     {
387         head = QString( data->name );
388         p_item++; // Why that ?
389     }
390     else
391     {
392         head = QString( qfu(p_module->psz_longname) );
393         if( p_module->psz_help )
394         {
395             help.append( "\n" );
396             help.append( qfu( p_module->psz_help ) );
397         }
398     }
399
400     QLabel *label = new QLabel( head );
401     global_layout->addWidget( label );
402     QFont myFont = QApplication::font( static_cast<QWidget*>(0) );
403     myFont.setPointSize( myFont.pointSize() + 3 ); myFont.setBold( true );
404     label->setFont( myFont );
405
406     QLabel *helpLabel = new QLabel( help, this );
407     helpLabel->setWordWrap( true );
408
409     global_layout->addWidget( helpLabel );
410
411     QGroupBox *box = NULL;
412     QGridLayout *boxlayout = NULL;
413
414     QScrollArea *scroller= new QScrollArea;
415     scroller->setFrameStyle( QFrame::NoFrame );
416     QWidget *scrolled_area = new QWidget;
417
418     QGridLayout *layout = new QGridLayout();
419     int i_line = 0, i_boxline = 0;
420     bool has_hotkey = false;
421
422     if( p_item ) do
423     {
424         if( ( ( data->i_type == TYPE_SUBCATEGORY &&
425                 p_item->value.i != data->i_object_id ) ||
426               ( data->i_type == TYPE_CATSUBCAT  &&
427                 p_item->value.i != data->i_subcat_id ) ) &&
428             ( p_item->i_type == CONFIG_CATEGORY ||
429               p_item->i_type == CONFIG_SUBCATEGORY ) )
430             break;
431         if( p_item->b_internal == VLC_TRUE ) continue;
432
433         if( p_item->i_type == CONFIG_SECTION )
434         {
435             if( box )
436             {
437                 box->setLayout( boxlayout );
438                 layout->addWidget( box, i_line, 0, 1, 2 );
439                 i_line++;
440             }
441             box = new QGroupBox( qfu(p_item->psz_text) );
442             boxlayout = new QGridLayout();
443         }
444         /* Only one hotkey control */
445         if( has_hotkey && p_item->i_type & CONFIG_ITEM && p_item->psz_name &&
446                                          strstr( p_item->psz_name, "key-" ) )
447             continue;
448         if( p_item->i_type & CONFIG_ITEM && p_item->psz_name &&
449                                             strstr( p_item->psz_name, "key-" ) )
450             has_hotkey = true;
451
452         ConfigControl *control;
453         if( ! box )
454             control = ConfigControl::createControl( VLC_OBJECT( p_intf ),
455                                         p_item, NULL, layout, i_line );
456         else
457             control = ConfigControl::createControl( VLC_OBJECT( p_intf ),
458                                     p_item, NULL, boxlayout, i_boxline );
459         if( !control )
460             continue;
461
462         if( has_hotkey )
463         {
464             /* A hotkey widget takes 2 lines */
465             if( box ) i_boxline ++;
466             else i_line++;
467         }
468
469         if( box ) i_boxline++;
470         else i_line++;
471         controls.append( control );
472     }
473     while( !( ( data->i_type == TYPE_SUBCATEGORY ||
474                data->i_type == TYPE_CATSUBCAT ) &&
475              ( p_item->i_type == CONFIG_CATEGORY ||
476                p_item->i_type == CONFIG_SUBCATEGORY ) )
477         && ( ++p_item < p_end ) );
478
479     if( box )
480     {
481         box->setLayout( boxlayout );
482         layout->addWidget( box, i_line, 0, 1, 2 );
483     }
484
485     vlc_object_release( p_module );
486
487     scrolled_area->setSizePolicy( QSizePolicy::Preferred,QSizePolicy::Fixed );
488     scrolled_area->setLayout( layout );
489     scroller->setWidget( scrolled_area );
490     scroller->setWidgetResizable( true );
491     global_layout->addWidget( scroller );
492     setLayout( global_layout );
493 }
494
495 void PrefsPanel::apply()
496 {
497     QList<ConfigControl *>::Iterator i;
498     for( i = controls.begin() ; i != controls.end() ; i++ )
499     {
500         ConfigControl *c = qobject_cast<ConfigControl *>(*i);
501         c->doApply( p_intf );
502     }
503 }
504 void PrefsPanel::clean()
505 {}