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