titleWidget.cpp

Go to the documentation of this file.

//==============================================
//  copyright            : (C) 2003 by Will Stokes
//==============================================
//  This program is free software; you can redistribute it 
//  and/or modify it under the terms of the GNU General 
//  Public License as published by the Free Software 
//  Foundation; either version 2 of the License, or  
//  (at your option) any later version.         
//
//  As a special exception, Will Stokes gives permission to 
//  link this program with Qt non-commercial edition, and 
//  distribute the resulting executable, without including the 
//  source code for the Qt non-commercial edition in the 
//  source distribution. 
//==============================================

//Systemwide includes
#include <qwidget.h>
#include <qmenubar.h>
#include <qpopupmenu.h>
#include <qlayout.h>
#include <qlabel.h>
#include <qfont.h>
#include <qpixmap.h>
#include <qimage.h>
#include <qtoolbutton.h>
#include <qlineedit.h>
#include <qapplication.h>
#include <qdir.h>
#include <qcursor.h>
#include <qfiledialog.h>
#include <qtooltip.h>

//Projectwide includes
#include "window.h"
#include "albumStatistics.h"
#include "about.h"
#include "handbook.h"
#include "titleWidget.h"
#include "layoutWidget.h"
#include "subalbumsWidget.h"
#include "subalbumWidget.h"
#include "questionDialog.h"
#include "alertDialog.h"
#include "../backend/album.h"
#include "../backend/photo.h"
#include "../config.h"
#include "guiTools.h"
#include "statusWidget.h"
#include "saveDialog.h"

//==============================================
TitleWidget::TitleWidget(QWidget *parent, 
                         const char* name ) : QFrame(parent,name)
{
  window = (Window*)parent;

  albumStats = NULL;
  
  about = NULL;
  
  handbookWindow = NULL;
  
  //create menus
  menu = new QMenuBar( this, "menuBar" );
  
  file = new QPopupMenu( this, "fileMenu" );
  NEW_ALBUM = file->insertItem( tr("&New"), this, SLOT(newAlbum()), CTRL+Key_N );
  OPEN_ALBUM = file->insertItem( tr("&Open"), this, SLOT(loadAlbum()), CTRL+Key_O );
  SAVE_ALBUM = file->insertItem( tr("&Save"), this, SLOT(saveAlbum()), CTRL+Key_S );
  SAVEAS_ALBUM = file->insertItem( tr("&Save As"), this, SLOT(saveAsAlbum()), CTRL+SHIFT+Key_S );
//  SMALL_SAVE = file->insertItem( tr("Small Save"), this, SLOT(smallSave()) );
  file->insertItem( tr("&Quit"), this, SLOT(quitApplication()), CTRL+Key_Q);
  
  tools = new QPopupMenu( this, "toolsMenu" );
  tools->insertItem( tr("Album Statistics"), this, SLOT(albumStatistics()) );
  
  help = new QPopupMenu( this, "helpMenu" );
  help->insertItem( tr("Handbook"), this, SLOT(handbook()) );
  help->insertItem( tr("&About"), this, SLOT(aboutProgram()) );
  
  menu->insertItem( tr("&File"), file );
  menu->insertItem( tr("&Tools"), tools );
  menu->insertSeparator();
  menu->insertItem( tr("&Help"), help );
  
  //create backend album object
  albm = new Album();

  //create labels and text entries
  albumName = new QLabel( this );
  albumName->setText( tr("Album Name:") );
  albumName->setFont( QFont( "Times", 12, QFont::Bold ) );
  albumNameVal = new QLineEdit( this );
  albumNameVal->setFont( QFont( "Times", 12, QFont::Bold ) );
  connect( albumNameVal, SIGNAL(textChanged( const QString&)),
           SLOT( updateName(const QString&)) );
  
  albumDescription = new QLabel( this );
  albumDescription->setText( tr("Description:") );
  albumDescription->setFont( QFont( "Times", 12, QFont::Bold ) );
  albumDescriptionVal = new QLineEdit( this );
  albumDescriptionVal->setFont( QFont( "Times", 12, QFont::Bold ) );
  connect( albumDescriptionVal, SIGNAL(textChanged( const QString&)),
           SLOT( updateDescription(const QString&)) );

  albumAuthor = new QLabel( this );
  albumAuthor->setText( tr("Author:") );
  albumAuthor->setFont( QFont( "Times", 12, QFont::Bold ) );
  albumAuthorVal = new QLineEdit( this );
  albumAuthorVal->setFont( QFont( "Times", 12, QFont::Bold ) );
  connect( albumAuthorVal, SIGNAL(textChanged( const QString&)),
           SLOT( updateAuthor(const QString&)) );
  
  //create set image button
  representativeImageText = new QLabel( this );
  representativeImageText->setText( tr("Thumbnail:") );
  representativeImageText->setFont( QFont( "Times", 12, QFont::Bold ) );
  
  QFont buttonFont( qApp->font() );
  buttonFont.setBold(true);
  buttonFont.setPointSize( 11 );
  
  setImage = new QToolButton( this );
  setImage->setTextLabel(tr("Set") );
  setImage->setTextPosition(QToolButton::Right);
  setImage->setFont( buttonFont );
  setImage->setUsesTextLabel( true );
  setImage->setEnabled(false);
  QToolTip::add( setImage, tr("Set album image to selected photo") );
  connect( setImage, SIGNAL(clicked()), SLOT(setImageAction()) );
  
  //create representative image
  representativeLogo = new QLabel( this );
  representativeLogo->setPixmap( *albm->getRepresentativeImage(SMALL) );
           
  //create album Shaper image
  albumShaperLogo = new QLabel( this );
  albumShaperLogo->setPixmap( QPixmap( QString(IMAGE_PATH)+"albumShaper.png" ) );

  //Create horizontal line
  line = new QFrame(this);
  line->setFrameShadow( QFrame::Plain );
  line->setLineWidth( 2 );
  line->setFrameShape( QFrame::HLine );

  //place all labels in grid layout
  grid = new QGridLayout( this, 5, 7, 0 );
  grid->addMultiCellWidget( menu, 0, 0, 0, 6 );
  grid->addWidget( albumName,                   1, 0, Qt::AlignLeft);
  grid->addWidget( albumNameVal,                1, 1);
  grid->addWidget( albumDescription,            2, 0, Qt::AlignLeft);
  grid->addWidget( albumDescriptionVal,         2, 1);
  grid->addWidget( albumAuthor,                 3, 0, Qt::AlignLeft);
  grid->addWidget( albumAuthorVal,              3, 1);
  grid->addWidget( representativeImageText,     1, 3, Qt::AlignLeft );
  grid->addWidget( setImage,                    2, 3, Qt::AlignLeft );
  grid->addMultiCellWidget( representativeLogo, 1, 3, 4, 4 );
  grid->addMultiCellWidget( line,               4, 4, 0, 6);
  grid->addMultiCellWidget( albumShaperLogo,     1, 3, 6, 6 );

  //Set the second column, the actual album name and description and author
  //to have a minimum width
  grid->addColSpacing(1, 300 );

  //create blank space between album name/desc/author and the thumbnail
  grid->addColSpacing(2, 10 );
    
  //set the blank colum to stretch more than others to take
  //up leftover room
  grid->setColStretch( 4, 1 );

  //set the background of the widget to be white
  setPaletteBackgroundColor( QColor(255, 255, 255) );
  
  busy = false;
}
//==============================================
void TitleWidget::updateName( const QString& val )
{
  albm->setName(val);
}
//==============================================
void TitleWidget::updateDescription( const QString& val )
{
  albm->setDescription(val);
}
//==============================================
void TitleWidget::updateAuthor( const QString& val )
{
  albm->setAuthor(val);
}
//==============================================
void TitleWidget::setAlbum( Album* val)
{
  //delete old album
  delete albm;
  albm = val;
}
//==============================================
Album* TitleWidget::getAlbum()
{
  return albm;
}
//==============================================
//called when user clicks "set image" button
void TitleWidget::setImageAction()
{
  //---------------------------------------------------------    
  //determine if a subalbum is even selected
  SubalbumWidget* sw = window->getLayout()->getSubalbum();
  if(sw == NULL)
    return;
  //---------------------------------------------------------        
  //determine if a photo is selected
  Photo* selectedPhoto = sw->getSelectedPhoto();
  if(selectedPhoto == NULL)
    return;
  //---------------------------------------------------------     
  //set representative iamges
  QImage* img = selectedPhoto->getImage(IMAGE);
  albm->setRepresentativeImages( img );
  delete img;
  img = NULL;
  //---------------------------------------------------------    
  //update onscreen images
  representativeLogo->setPixmap( *(albm->getRepresentativeImage(SMALL)) );
  //---------------------------------------------------------    
}
//==============================================
void TitleWidget::refresh()
{
  albumNameVal->setText( albm->getName() );
  albumDescriptionVal->setText( albm->getDescription() );
  albumAuthorVal->setText( albm->getAuthor() );
  representativeLogo->setPixmap( *(albm->getRepresentativeImage(SMALL)) );
}                 
//==============================================
void TitleWidget::newAlbum()
{
  //if modifications exist ask user if they are sure before creating a new album
  if(albm->albumModified() )
  {
    QuestionDialog sure( tr("New album?"),
                                   tr("Warning, unsaved modifications to the current album exist. Creating a new album will result in lost work. Are you sure you want to do this?"),    
                                   "warning.png",
                                   this );
    if(!sure.exec())
      return;
  }
    
  //delete old album
  delete albm;
    
  //create new one
  albm = new Album();
  
  //refresh screen
  refresh();
  window->refresh();
  
  albm->setModified(false);
}
//==============================================
void TitleWidget::loadAlbum()
{
  //if unsaved modifications exist as the user before proceding with loading a new album
  if(albm->albumModified() )
  {
    QuestionDialog sure( tr("Load album?"),
                                   tr("Warning, unsaved modifications to the current album exist. Loading a new album will result in lost work. Are you sure you want to do this?"),
                                   "warning.png",
                                   this );
    if(!sure.exec())
      return;
  }

  //set busy flag and deactivate buttons
  setBusy(true);
  window->getLayout()->getSubalbums()->updateButtons(false);
  if(window->getLayout()->getSubalbum() != NULL)
    window->getLayout()->getSubalbum()->updateButtons(false);
  
  QString albumXML = QFileDialog::getOpenFileName(NULL,
                                                  tr("XML Files (*.xml)"),
                                                  this,
                                                  "open file dialog",
                                                  tr("Choose an album to load") );

  //if null return
  if(albumXML.isNull())
  {
    //nolonger busy
    setBusy(false);
    window->getLayout()->getSubalbums()->updateButtons(true);
    if(window->getLayout()->getSubalbum() != NULL)
      window->getLayout()->getSubalbum()->updateButtons(true);
    return;
  }
    
  qApp->setOverrideCursor( QCursor(Qt::WaitCursor));
  
  //create a new album
  delete albm;
  albm = new Album();
  
  //attempt to load xml file
  
  int errorCode = albm->importFromDisk(window->getStatus(), albumXML );
   
  //refresh screen
  refresh();
  window->refresh();
  
  //set album as not modified
  albm->setModified(false);
  
  //nolonger busy
  setBusy(false);
  window->getLayout()->getSubalbums()->updateButtons(true);
  if(window->getLayout()->getSubalbum() != NULL)
    window->getLayout()->getSubalbum()->updateButtons(true);
  qApp->restoreOverrideCursor();
  
  
  if(errorCode != ALBUM_LOADED)
  {
    QString errorMessage, errorDescription;
    if(errorCode == ALBUM_READ_ERROR)
    {
      errorMessage = tr("Unable to open file!");
      errorDescription = tr("An error was encountered attempting to load the XML file. Perhaps you do not have read access?");
    }
    else if(errorCode == ALBUM_XML_ERROR)
    {
      errorMessage = tr("Unable to construct DOM!");
      errorDescription = tr("The XML file you selected is not valid XML.");
    }
    else
    {
      errorMessage = tr("Unknown loading error!");
      errorDescription = tr("An unknown error was encountered loading the specified file.");
    }
        
    AlertDialog alert( errorMessage, errorDescription, "warning.png", this );
    alert.exec();
  }
}
//==============================================
void TitleWidget::smallSave()
{
//  saveAsAlbum(true);
}
//==============================================
void TitleWidget::saveAlbum(bool smallSave)
{
  //if album not previously saved then
  //run saveas dialog
  if(!getAlbum()->prevSave())
  {
    saveAsAlbum(smallSave);
    return;
  }
  
  //if previously used theme not available for use again alert user, 
  //then run saveas dialog
  if(!SaveDialog::themeAvailable( getAlbum()->getTheme() ))
  {
    AlertDialog alert( tr("Previous theme not available!"),
                            tr("Theme previously used to save this album not available on this machine. Click ok to open the save-as dialog to save an alternative theme."), 
                            "warning.png", this );
    alert.exec();
    saveAsAlbum(smallSave);
    return;
  }
  
  //set busy flag and disable buttons
  setBusy(true);
  window->getLayout()->getSubalbums()->updateButtons(false);
  if(window->getLayout()->getSubalbum() != NULL)
    window->getLayout()->getSubalbum()->updateButtons(false);
  qApp->setOverrideCursor( QCursor(Qt::WaitCursor));
    
  //sync current subalbum to ensure all photo descriptions saved
  if(  window->getLayout()->getSubalbum() != NULL )
    window->getLayout()->getSubalbum()->syncPhotos();
    
  getAlbum()->exportToDisk(window->getStatus(), smallSave);  
      
  //nolonger busy
  setBusy(false);
  window->getLayout()->getSubalbums()->updateButtons(true);
  if(window->getLayout()->getSubalbum() != NULL)
    window->getLayout()->getSubalbum()->updateButtons(true);
  qApp->restoreOverrideCursor();
}
//==============================================
void TitleWidget::saveAsAlbum(bool smallSave)
{
  //setup dialog title and default path
  QString dialogTitle, defaultPath;
  if(smallSave)
    dialogTitle = tr( "Small Save As:" );
  else
    dialogTitle = tr( "Save As:" );
  if(getAlbum()->prevSave())
    defaultPath = getAlbum()->getSaveLocation();
  else
  {
    defaultPath = QDir::homeDirPath() + "/" + getAlbum()->getName();  
    defaultPath.replace( QChar(' '), "_" );
    defaultPath.replace( "<", "" );
    defaultPath.replace( ">", "" );
    defaultPath.replace( "&", "and" );
    defaultPath.replace( "\"", "" );
    defaultPath.replace( "\'", "" );
    defaultPath.replace( "?", "" );
  }
  
  //get directory name in which album directory will be placed in
  QString theme, savePath;  
  theme = getAlbum()->getTheme();
  if( !SaveDialog::selectThemeAndPath( dialogTitle, defaultPath, theme, savePath ) )
    return;
      
  //check if directory already exists, if not attempt to create it
  QDir d(savePath);
  if(!d.exists())
  {
    if(!d.mkdir(savePath))
    {      
      AlertDialog alert( tr("Error creating directory!"), 
                              tr("Unable to create directory to save album in. Perhaps you are running out of disk space or you don't have sufficient privledges?"),
                              "warning.png", this );
      alert.exec();
      return;
    }
  }
  else
  {
    if(!d.isReadable())
    {
      AlertDialog alert( tr("Destination directory not readable!"), 
                              tr("The destination directory is not readable. Perhaps you don't have sufficient privledges?"),
                              "warning.png", this );
      alert.exec();
      return;
    }
  }
  
  //set busy flag and disable buttons
  setBusy(true);
  window->getLayout()->getSubalbums()->updateButtons(false);
  if(window->getLayout()->getSubalbum() != NULL)
    window->getLayout()->getSubalbum()->updateButtons(false);
  qApp->setOverrideCursor( QCursor(Qt::WaitCursor));
    
  //sync current subalbum to ensure all photo descriptions saved
  if(  window->getLayout()->getSubalbum() != NULL )
    window->getLayout()->getSubalbum()->syncPhotos();
    
  //save
  getAlbum()->exportToDisk(window->getStatus(), smallSave, savePath, theme);
      
  //nolonger busy
  setBusy(false);
  window->getLayout()->getSubalbums()->updateButtons(true);
  if(window->getLayout()->getSubalbum() != NULL)
    window->getLayout()->getSubalbum()->updateButtons(true);
  qApp->restoreOverrideCursor();
}
//==============================================
void TitleWidget::albumStatistics()
{
  //create window and center, always create a new window
  //in case album information has changed
  if(albumStats != NULL)
    delete albumStats;
    
  albumStats = new AlbumStatistics(albm);
  connect( albumStats, SIGNAL(albumStatisticsClosed()),
           this, SLOT(albumStatisticsClosed()));
  albumStats->show();
  centerWindow(albumStats);
}
//==============================================
void TitleWidget::aboutProgram()
{
  //create window and center if not already present
  if(about == NULL)
  {
    about = new About();
    connect( about, SIGNAL(aboutClosed()),
             this, SLOT(aboutClosed()));
    about->show();
    centerWindow(about);
  }
  //else raise window
  else
  {
    about->raise();   
  }
}
//==============================================
void TitleWidget::handbook()
{
  //create window and center if not already present
  if(handbookWindow == NULL)
  {
    handbookWindow = new Handbook(0);
    connect( handbookWindow, SIGNAL(closed()),
             this, SLOT(handbookClosed()));
    handbookWindow->show();
    centerWindow(handbookWindow);
  }
  //else raise window
  else
  {
    handbookWindow->raise();   
  }
}
//==============================================
void TitleWidget::albumStatisticsClosed()
{
  delete albumStats;
  albumStats = NULL;
}
//==============================================
void TitleWidget::aboutClosed()
{
  delete about;
  about = NULL;
}
//==============================================
void TitleWidget::handbookClosed()
{
  delete handbookWindow;
  handbookWindow = NULL;
}
//==============================================
void TitleWidget::setSetButtonState(bool state)
{
  setImage->setEnabled(state);
}
//==============================================
bool TitleWidget::getBusy()
{
  return busy;
}
//==============================================
void TitleWidget::setBusy(bool val)
{
  busy = val;
  
  //disable/enable file operations
  if(busy)
  {
    file->setItemEnabled(NEW_ALBUM, false);
    file->setItemEnabled(OPEN_ALBUM, false);
    file->setItemEnabled(SAVE_ALBUM, false);
    file->setItemEnabled(SAVEAS_ALBUM, false);
    cacheSetButtonState = setImage->isEnabled();
    setSetButtonState(false);
  }
  else
  {
    file->setItemEnabled(NEW_ALBUM, true);
    file->setItemEnabled(OPEN_ALBUM, true);
    file->setItemEnabled(SAVE_ALBUM, true);
    file->setItemEnabled(SAVEAS_ALBUM, true);
    setSetButtonState(cacheSetButtonState);
  }
}
//==============================================
void TitleWidget::quitApplication()
{
  window->close();
}
//==============================================

---