git.sesse.net Git - vlc/blob - modules/gui/qt4/dialogs/help.cpp

   1 /*****************************************************************************
   2  * Help.cpp : Help and About dialogs
   3  ****************************************************************************
   4  * Copyright (C) 2007 the VideoLAN team
   5  * $Id$
   6  *
   7  * Authors: Jean-Baptiste Kempf <jb (at) videolan.org>
   8  *          Rémi Duraffort <ivoire (at) via.ecp.fr>
   9  *
  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.
  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 General Public License for more details.
  19  *
  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  *****************************************************************************/
  24
  25 #ifdef HAVE_CONFIG_H
  26 # include "config.h"
  27 #endif
  28
  29 #include <vlc_common.h>
  30
  31 #include "dialogs/help.hpp"
  32 #include <vlc_about.h>
  33
  34 #ifdef UPDATE_CHECK
  35 #include <vlc_update.h>
  36 #endif
  37
  38 #include "dialogs_provider.hpp"
  39
  40 #include <vlc_intf_strings.h>
  41
  42 #include <QTextBrowser>
  43 #include <QTabWidget>
  44 #include <QFile>
  45 #include <QLabel>
  46 #include <QString>
  47 #include <QDialogButtonBox>
  48 #include <QEvent>
  49 #include <QFileDialog>
  50 #include <QDate>
  51
  52
  53 HelpDialog *HelpDialog::instance = NULL;
  54
  55 HelpDialog::HelpDialog( intf_thread_t *_p_intf ) : QVLCFrame( _p_intf )
  56
  57 {
  58     setWindowTitle( qtr( "Help" ) );
  59     setMinimumSize( 250, 300 );
  60
  61     QGridLayout *layout = new QGridLayout( this );
  62     QTextBrowser *helpBrowser = new QTextBrowser( this );
  63     helpBrowser->setOpenExternalLinks( true );
  64     helpBrowser->setHtml( I_LONGHELP );
  65     QPushButton *closeButton = new QPushButton( qtr( "&Close" ) );
  66     closeButton->setDefault( true );
  67
  68     layout->addWidget( helpBrowser, 0, 0, 1, 0 );
  69     layout->addWidget( closeButton, 1, 3 );
  70
  71     BUTTONACT( closeButton, close() );
  72     readSettings( "Help", QSize( 400, 450 ) );
  73 }
  74
  75 HelpDialog::~HelpDialog()
  76 {
  77     writeSettings( "Help" );
  78 }
  79
  80 void HelpDialog::close()
  81 {
  82     toggleVisible();
  83 }
  84
  85 AboutDialog *AboutDialog::instance = NULL;
  86
  87 AboutDialog::AboutDialog( QWidget *parent, intf_thread_t *_p_intf)
  88             : QVLCDialog( parent, _p_intf )
  89 {
  90     setWindowTitle( qtr( "About" ) );
  91     resize( 600, 500 );
  92     setMinimumSize( 600, 500 );
  93
  94     QGridLayout *layout = new QGridLayout( this );
  95     QTabWidget *tab = new QTabWidget( this );
  96
  97     QPushButton *closeButton = new QPushButton( qtr( "&Close" ) );
  98     closeButton->setSizePolicy( QSizePolicy::Minimum, QSizePolicy::Minimum );
  99     closeButton->setDefault( true );
 100
 101     QLabel *introduction = new QLabel(
 102             qtr( "VLC media player" " " VERSION_MESSAGE ) );
 103     QLabel *iconVLC = new QLabel;
 104     if( QDate::currentDate().dayOfYear() >= 354 )
 105         iconVLC->setPixmap( QPixmap( ":/vlc48-christmas.png" ) );
 106     else
 107         iconVLC->setPixmap( QPixmap( ":/vlc48.png" ) );
 108     layout->addWidget( iconVLC, 0, 0, 1, 1 );
 109     layout->addWidget( introduction, 0, 1, 1, 7 );
 110     layout->addWidget( tab, 1, 0, 1, 8 );
 111     layout->addWidget( closeButton, 2, 6, 1, 2 );
 112
 113     /* Main Introduction */
 114     QWidget *infoWidget = new QWidget( this );
 115     QHBoxLayout *infoLayout = new QHBoxLayout( infoWidget );
 116     QLabel *infoLabel = new QLabel(
 117             qtr( "VLC media player is a free media player, "
 118                 "encoder and streamer that can read from files, "
 119                 "CDs, DVDs, network streams, capture cards and even more!\n"
 120                 "VLC uses its internal codecs and works on essentially every "
 121                 "popular platform.\n\n" )
 122             + qtr( "This version of VLC was compiled by:\n " )
 123             + qfu( VLC_CompileBy() )+ "@" + qfu( VLC_CompileHost() ) + "."
 124             + qfu( VLC_CompileDomain() ) + ".\n"
 125             + "Compiler: " + qfu( VLC_Compiler() ) + ".\n"
 126             + qtr( "Based on Git commit: " ) + qfu( VLC_Changeset() ) + ".\n"
 127             + qtr( "You are using the Qt4 Interface.\n\n" )
 128             + qtr( "Copyright (C) " COPYRIGHT_YEARS " by the VideoLAN Team.\n" )
 129             + "vlc@videolan.org, http://www.videolan.org" );
 130     infoLabel->setWordWrap( infoLabel );
 131
 132     QLabel *iconVLC2 = new QLabel;
 133     if( QDate::currentDate().dayOfYear() >= 354 )
 134         iconVLC2->setPixmap( QPixmap( ":/vlc128-christmas.png" ) );
 135     else
 136         iconVLC2->setPixmap( QPixmap( ":/vlc128.png" ) );
 137     infoLayout->addWidget( iconVLC2 );
 138     infoLayout->addWidget( infoLabel );
 139
 140     /* GPL License */
 141     QTextEdit *licenseEdit = new QTextEdit( this );
 142     licenseEdit->setText( qfu( psz_license ) );
 143     licenseEdit->setReadOnly( true );
 144
 145     /* People who helped */
 146     QWidget *thanksWidget = new QWidget( this );
 147     QVBoxLayout *thanksLayout = new QVBoxLayout( thanksWidget );
 148
 149     QLabel *thanksLabel = new QLabel( qtr( "We would like to thank the whole "
 150                 "VLC community, the testers, our users and the following people "
 151                 "(and the missing ones...) for their collaboration to "
 152                 "create the best free software." ) );
 153     thanksLabel->setWordWrap( true );
 154     thanksLayout->addWidget( thanksLabel );
 155     QTextEdit *thanksEdit = new QTextEdit( this );
 156     thanksEdit->setText( qfu( psz_thanks ) );
 157     thanksEdit->setReadOnly( true );
 158     thanksLayout->addWidget( thanksEdit );
 159
 160     /* People who wrote the software */
 161     QTextEdit *authorsEdit = new QTextEdit( this );
 162     authorsEdit->setText( qfu( psz_authors ) );
 163     authorsEdit->setReadOnly( true );
 164
 165     /* add the tabs to the Tabwidget */
 166     tab->addTab( infoWidget, qtr( "About" ) );
 167     tab->addTab( authorsEdit, qtr( "Authors" ) );
 168     tab->addTab( thanksWidget, qtr("Thanks") );
 169     tab->addTab( licenseEdit, qtr("License") );
 170
 171     BUTTONACT( closeButton, close() );
 172 }
 173
 174 AboutDialog::~AboutDialog()
 175 {
 176 }
 177
 178 void AboutDialog::close()
 179 {
 180     toggleVisible();
 181 }
 182
 183 #ifdef UPDATE_CHECK
 184
 185 /*****************************************************************************
 186  * UpdateDialog
 187  *****************************************************************************/
 188 /* callback to get information from the core */
 189 static void UpdateCallback( void *data, bool b_ret )
 190 {
 191     UpdateDialog* UDialog = (UpdateDialog *)data;
 192     QEvent* event;
 193
 194     if( b_ret )
 195         event = new QEvent( (QEvent::Type)UDOkEvent );
 196     else
 197         event = new QEvent( (QEvent::Type)UDErrorEvent );
 198
 199     QApplication::postEvent( UDialog, event );
 200 }
 201
 202 UpdateDialog *UpdateDialog::instance = NULL;
 203
 204 UpdateDialog::UpdateDialog( intf_thread_t *_p_intf ) : QVLCFrame( _p_intf )
 205 {
 206     setWindowTitle( qtr( "Update" ) );
 207
 208     QGridLayout *layout = new QGridLayout( this );
 209
 210     QPushButton *closeButton = new QPushButton( qtr( "&Close" ) );
 211     updateButton = new QPushButton( qtr( "&Update List" ) );
 212     updateButton->setDefault( true );
 213     QDialogButtonBox *buttonBox = new QDialogButtonBox( Qt::Horizontal );
 214     buttonBox->addButton( updateButton, QDialogButtonBox::ActionRole );
 215     buttonBox->addButton( closeButton, QDialogButtonBox::AcceptRole );
 216
 217     updateLabel = new QLabel( qtr( "Checking for an update..." ) );
 218     updateLabel->setWordWrap( true );
 219
 220     layout->addWidget( updateLabel, 0, 0 );
 221     layout->addWidget( buttonBox, 1, 0 );
 222
 223     BUTTONACT( updateButton, UpdateOrDownload() );
 224     BUTTONACT( closeButton, close() );
 225
 226     /* Create the update structure */
 227     p_update = update_New( p_intf );
 228     b_checked = false;
 229
 230     readSettings( "Update", QSize( 120, 80 ) );
 231
 232     /* Check for updates */
 233     UpdateOrDownload();
 234 }
 235
 236 UpdateDialog::~UpdateDialog()
 237 {
 238     update_Delete( p_update );
 239     writeSettings( "Update" );
 240 }
 241
 242 void UpdateDialog::close()
 243 {
 244     toggleVisible();
 245 }
 246
 247 /* Check for updates */
 248 void UpdateDialog::UpdateOrDownload()
 249 {
 250     if( !b_checked )
 251     {
 252         updateButton->setEnabled( false );
 253         msg_Dbg( p_intf, "Launching an update request" );
 254         update_Check( p_update, UpdateCallback, this );
 255     }
 256     else
 257     {
 258         updateButton->setEnabled( false );
 259         QString dest_dir = QFileDialog::getExistingDirectory( this,
 260                                  qtr( "Select a directory..." ),
 261                                  qfu( config_GetHomeDir() ) );
 262
 263         if( dest_dir != "" )
 264         {
 265             toggleVisible();
 266             update_Download( p_update, qtu( dest_dir ) );
 267         }
 268         else
 269             updateButton->setEnabled( true );
 270     }
 271 }
 272
 273 /* Handle the events */
 274 void UpdateDialog::customEvent( QEvent *event )
 275 {
 276     if( event->type() == UDOkEvent )
 277         updateNotify( true );
 278     else
 279         updateNotify( false );
 280 }
 281
 282 /* Notify the end of the update_Check */
 283 void UpdateDialog::updateNotify( bool b_result )
 284 {
 285     /* The update finish without errors */
 286     if( b_result )
 287     {
 288         if( update_NeedUpgrade( p_update ) )
 289         {
 290             update_release_t *p_release = update_GetRelease( p_update );
 291             assert( p_release );
 292             b_checked = true;
 293             updateButton->setText( "Download" );
 294             updateLabel->setText( qtr( "There is a new version of VLC :\n" )
 295                                 + qfu( p_release->psz_desc )  );
 296
 297             /* Force the dialog to be shown */
 298             this->show();
 299         }
 300         else
 301             updateLabel->setText( qtr( "You have the latest version of VLC" ) );
 302     }
 303     else
 304         updateLabel->setText(
 305                         qtr( "An error occurred while checking for updates" ) );
 306
 307     adjustSize();
 308     updateButton->setEnabled( true );
 309 }
 310
 311 #endif
 312