TitleWidget Class Reference

Widget which displays album name, description, representative image, and album shaper logo. More...

#include <titleWidget.h>

Inheritance diagram for TitleWidget:

Collaboration diagram for TitleWidget:

Public Slots
void	albumStatisticsClosed ()
	Frees album statistics dialog once closed.
void	aboutClosed ()
	Frees about dialog once closed.
void	helpClosed ()
	Frees HelpWindow once closed.
void	quitApplication ()
	Quit slot.
void	settingsWindowClosed ()
void	updateAlbumAnnotations ()
	Updates subalbum annotations.
void	refreshCollectionAnnotations (Subalbum *collection)
	Update displayed collection name and cover image.
void	setAlbumImage (Photo *photo)
	Sets the album image to the passed in photo.
void	setSubalbumImage (Photo *photo)
	Sets the subalbum image to the passed in photo.
void	aboutProgram (int mode=ABOUT)
	Pops up about dialog.
void	help ()
	Pops up HelpWindow.
void	windowStateChanged (bool state)
	Enables/disables "minimize" window menu entry depending on window state.
void	updateMenus (bool anySelected=false, bool anyRevertable=false)
	update begin presentation menu entry - disabled when no photos in album

Signals
void	subalbumNameChanged ()
	Emitted when user changes subalbum name.

Public Member Functions
	TitleWidget (QWidget *parent=0, const char *name=0)
	Creates layout.
	~TitleWidget ()
	Deletes stuff!
void	useAnimation (bool val)
	Use animation for rep images?
void	setAlbum (Album *val)
	Sets new pointer to the album object.
Album *	getAlbum ()
	Returns a pointer to the album object.
void	refresh ()
	Refreshs data from backend objects.
bool	getBusy ()
	is program busy?
void	setBusy (bool val)
	set program busy state
RecentAlbums *	getRecentAlbums ()
	returns handle to recent albums object

Protected Member Functions
void	dragEnterEvent (QDragEnterEvent *e)
void	dropEvent (QDropEvent *e)
QString	createTmpDir (QString albumPath=QString::null)

Private Slots
void	storeAnnotations ()
	Store annotations.
void	setAlbumImage ()
	Sets the Album Image.
void	unsetAlbumImage ()
	Unsets the Album Image.
void	setSubalbumImage ()
	Sets the Subalbum Image.
void	unsetSubalbumImage ()
	Unsets the Subalbum Image.
void	newAlbum ()
	Resets to empty album.
void	loadAlbum ()
	Loads an album specified with file chooser.
void	loadRecentAlbum (int index)
	Loads a recent album.
bool	proceedWithLoad ()
	Helper function for load methods, checks if there are any unsaved changes and if so warns user any such changes will be lost if they proceed.
void	loadAlbum (QString location)
	Loads a specified album.
void	saveAlbum ()
	Saves album.
void	saveAsAlbum ()
	Saves album as.
void	revertToSaved ()
	Revert to last saved album.
void	exportSmallWebGallery ()
	Export small web gallery (excludes full size images and Album.xml file)
void	exportLargeImages ()
	Export large images only to a new directory for printing purposes.
void	settings ()
	Pops up settings window.
void	removeSelectedPhotoDesc ()
	Strip descriptions from selected photos.
void	revertPhotos ()
	Revert selected photos to original form.
void	albumStatistics ()
	Pops up album statistics window.
void	clearOpenRecentMenu ()
	Clears albums from open recent menu.

Private Member Functions
void	populateOpenRecentMenu ()
	Populates the open recent menu with a default set of 9 items + clear.
void	refreshOpenRecentMenu ()
	Refreshes open recent menu.

Private Attributes
QMenuBar *	menu
	Menubar file menu and help menu inserted in.
Q3PopupMenu *	file
	File menu.
Q3PopupMenu *	openRecent
	Open recent submenu.
int *	recentMenuItems
int	numRecentMenuItems
RecentAlbumMenuItem **	customRecentMenuItems
Q3PopupMenu *	photoMenu
	Photos menu.
Q3PopupMenu *	tools
	Tools menu.
Q3PopupMenu *	helpMenu
	Window menu, only used in OSX.
Q3GridLayout *	mainGrid
	Main grid.
Q3Frame *	mainFrame
Q3GridLayout *	albumAnnotationGrid
	Album annotation grid.
Q3Frame *	albumAnnotationFrame
ALabel *	albumImage
QLabel *	albumName
QLineEdit *	albumNameVal
QLabel *	albumDescription
QLineEdit *	albumDescriptionVal
QLabel *	albumAuthor
QLineEdit *	albumAuthorVal
Q3GridLayout *	subalbumAnnotationGrid
	Subalbum annotation grid.
Q3Frame *	subalbumAnnotationFrame
ALabel *	subalbumImage
QLabel *	subalbumName
QLineEdit *	subalbumNameVal
QLabel *	subalbumDescription
QLineEdit *	subalbumDescriptionVal
Album *	albm
	Backend album object.
Window *	window
	Window pointer.
AlbumStatistics *	albumStats
	Album Statistics dialog pointer.
ConfigurationWidget *	settingsWindow
	Settings dialog pointer.
About *	about
	About dialog pointer.
HelpWindow *	helpWindow
	HelpWindow pointer.
bool	busy
	Is the program currently busy? helps block other operations.
bool	detectModifications
int	NEW_ALBUM
int	OPEN_ALBUM
int	SAVE_ALBUM
int	SAVEAS_ALBUM
int	REVERT_TO_SAVED_ALBUM
int	EXPORT_SMALL_WEB_GALLERY
int	EXPORT_LARGE_IMAGES
int	REMOVE_DESCRIPTIONS
	photos menu item id's
int	REVERT_PHOTOS
int	BEGIN_PRESENTATION
	tools menu item id's
int	BEGIN_PRESENTATION_AT
bool	cacheSetButtonState
	cached set button state
QString	tmpDirErrorMessage
	error message and description when temp directory cannot be created
QString	tmpDirErrorDesc
RecentAlbums	recentAlbums

Detailed Description

Widget which displays album name, description, representative image, and album shaper logo.

Definition at line 56 of file titleWidget.h.

Constructor & Destructor Documentation

TitleWidget()

TitleWidget::TitleWidget	(	QWidget *	parent = 0,
		const char *	name = 0 )

Creates layout.

Store parent pointer

program not busy at first

no windows open by default

Definition at line 68 of file titleWidget.cpp.

                                                    : Q3Frame(parent,name)
{
  tmpDirErrorMessage = tr("Error! Unable to create temp directory!");
  tmpDirErrorDesc = tr("Album Shaper was unable to create the necessary temp directory required: ");
  //--------------------------------------------------------------
  QColor white(255, 255, 255);
  QColor lightBlue(193, 210, 238);
  QColor darkBlue(35, 75, 139);
  QColor black(0, 0, 0);
  //--------------------------------------------------------------
  window = (Window*)parent;
 
  busy = false;
 
  //detect changes to text fields
  detectModifications = true;
 
  albumStats = NULL;
  settingsWindow = NULL;
  about = NULL;
  helpWindow = NULL;
 
  //create backend album object
  albm = new Album( createTmpDir() );
  if(albm->getTmpDir().isNull() )
  {
      AlertDialog alert( tmpDirErrorMessage, tmpDirErrorDesc + window->getConfig()->getString( "loadSave", "tempImageDirectory" ),
      "alertIcons/warning.png", this );
      alert.exec();
      quitApplication();
  }
  //-------------------------------------
  //initialize recent albums object
  int i;
  QString recentName, recentLocation, recentPhotoCount;
  for(i = 0; i<recentAlbums.getMaxItems(); i++)
  {
    //get album name and location
    recentName = window->getConfig()->getString(    "recentAlbums", QString("%1_name").arg(i)     );
    recentLocation = window->getConfig()->getString("recentAlbums", QString("%1_location").arg(i) );
    recentPhotoCount = window->getConfig()->getString("recentAlbums", QString("%1_photoCount").arg(i) );
 
    //no such listing? since listings are continious all listings must be loaded
    if(recentLocation.compare("-1") == 0)
      break;
 
    //insert item into list
    recentAlbums.insertEntry( recentName, recentLocation, recentPhotoCount ); 
  }      
  //--------------------------------------------------------------
  //create menus
  menu = new QMenuBar( this, "menuBar" );
  //---
  //File menu
  file = new Q3PopupMenu( this, "fileMenu" );
  NEW_ALBUM = file->insertItem( QIcon( QPixmap(QString(IMAGE_PATH)+"menuIcons/new.png") ),
                                tr("&New"), this, SLOT(newAlbum()), Qt::CTRL+Qt::Key_N );
 
  OPEN_ALBUM = file->insertItem( QIcon( QPixmap(QString(IMAGE_PATH)+"menuIcons/open.png") ),
                                 tr("&Open..."), this, SLOT(loadAlbum()), Qt::CTRL+Qt::Key_O );
 
  openRecent = new Q3PopupMenu( this, "openRecentMenu" );
  populateOpenRecentMenu();
  refreshOpenRecentMenu();
  file->insertItem( tr("Open Recent"), openRecent );
  //----------------------
  file->insertSeparator();
  //----------------------  
  SAVE_ALBUM = file->insertItem( QIcon( QPixmap(QString(IMAGE_PATH)+"menuIcons/save.png") ),
                                 tr("&Save"), this, SLOT(saveAlbum()), Qt::CTRL+Qt::Key_S );
 
  SAVEAS_ALBUM = file->insertItem( QIcon( QPixmap(QString(IMAGE_PATH)+"menuIcons/saveas.png") ),
                                   tr("&Save As..."), this, SLOT(saveAsAlbum()), Qt::CTRL+Qt::SHIFT+Qt::Key_S );
 
  REVERT_TO_SAVED_ALBUM = file->insertItem( tr("Revert to Saved"), this, SLOT(revertToSaved()) );
  file->setItemEnabled( REVERT_TO_SAVED_ALBUM, false );  
  //----------------------
  file->insertSeparator();
  //----------------------
  Q3PopupMenu* exportAs = new Q3PopupMenu( this, "exportAs" );
  EXPORT_SMALL_WEB_GALLERY = exportAs->insertItem( tr("Small Web Gallery..."), 
                                                   this, SLOT(exportSmallWebGallery()) );
  EXPORT_LARGE_IMAGES = exportAs->insertItem( tr("Images for Printing..."), 
                                              this, SLOT(exportLargeImages()) );
  
  file->insertItem( tr("Export"), exportAs );
  //----------------------  
  file->insertSeparator();
  //----------------------
  file->insertItem( QIcon( QPixmap(QString(IMAGE_PATH)+"menuIcons/quit.png") ),
                    tr("&Quit"), this, SLOT(quitApplication()), Qt::CTRL+Qt::Key_Q);
 
  
  menu->insertItem( tr("&File"), file );
  //---
  //Photo menu
  photoMenu = new Q3PopupMenu( this, "phooMenu" );
    
  REMOVE_DESCRIPTIONS = photoMenu->insertItem( tr("Remove Description"), this, SLOT(removeSelectedPhotoDesc()) );
  REVERT_PHOTOS = photoMenu->insertItem( tr("Revert to Original"), this, SLOT(revertPhotos()) );
  
  menu->insertItem( tr("&Photos"), photoMenu );
  //---
  //Tools menu
  tools = new Q3PopupMenu( this, "toolsMenu" );
/*
  BEGIN_PRESENTATION_AT = tools->insertItem( QIconSet( QPixmap(QString(IMAGE_PATH)+"menuIcons/startPresentation.png") ),
                                          tr("Begin Presentation"), 
                                          window, SLOT(startSlideshowWithSelectedPhoto()), CTRL+Key_P );   
  BEGIN_PRESENTATION = tools->insertItem( tr("Begin Presentation at Beginning"), 
                                             window, SLOT(startSlideshowAtBeginning()), CTRL+SHIFT+Key_P ); 
  updateMenus();
 */
 
  tools->insertItem( QIcon( QPixmap(QString(IMAGE_PATH)+"menuIcons/albumStatistics.png") ),
                     tr("Album Statistics"), this, SLOT(albumStatistics()), Qt::CTRL+Qt::Key_I );
 
  tools->insertItem( QIcon( QPixmap(QString(IMAGE_PATH)+"menuIcons/settings.png") ),
                     tr("Settings"), this, SLOT(settings()) );
 
  menu->insertItem( tr("&Tools"), tools );
  //---
  //PLATFORM_SPECIFIC_CODE
  //Window menu
  #if defined(Q_OS_MACX)
  windowMenu = new Q3PopupMenu( this, "windoMenu" );
  WINDOW_MINIMIZE = windowMenu->insertItem( tr("&Minimize"), (QWidget*)window, SLOT(showMinimized()), Qt::CTRL+Qt::Key_M );
  menu->insertItem( tr("&Window"), windowMenu );
  #endif
  //---    
  //Help menu
  helpMenu = new Q3PopupMenu( this, "helpMenu" );
  helpMenu->insertItem( tr("Album Shaper Help"), this, SLOT(help()), Qt::CTRL+Qt::Key_Question );
 
  helpMenu->insertItem( QIcon( QPixmap(QString(IMAGE_PATH)+"menuIcons/about.png") ),
                    tr("About"), this, SLOT(aboutProgram()) );
  menu->insertSeparator();
  menu->insertItem( tr("&Help"), helpMenu );
  //--------------------------------------------------------------
  //create all widgets
  mainFrame = new Q3Frame( this, "mainFrame" );
  mainFrame->setPaletteBackgroundColor( darkBlue );
  //------
  //album annotations
  albumAnnotationFrame = new Q3Frame( mainFrame, "albumAnnotationFrame" );
  albumAnnotationFrame->setLineWidth(2);
  albumAnnotationFrame->setMidLineWidth(0);
  albumAnnotationFrame->setFrameStyle( Q3Frame::Panel | Q3Frame::Plain );
  albumAnnotationFrame->setPaletteForegroundColor( white );
  albumAnnotationFrame->setPaletteBackgroundColor( darkBlue );
 
  Q3Frame* albumImageFrame = new Q3Frame( albumAnnotationFrame, "albumImageFrame" );
  albumImage = new ALabel( albumImageFrame, "albumImage",
                                               new QPixmap( QString(IMAGE_PATH)+"buttonIcons/removeImage.png") );
  connect( albumImage, SIGNAL(mouseRelease()),
                this, SLOT(unsetAlbumImage()) );
 
  //allow drop events
  this->setAcceptDrops(true);
 
  albumName = new QLabel( tr("Album Name:"), albumAnnotationFrame, "albumName" );
  albumNameVal = new QLineEdit( albumAnnotationFrame, "albumNameVal" );
  connect( albumNameVal, SIGNAL(textChanged( const QString&)),
           SLOT( storeAnnotations()) );
 
  albumDescription = new QLabel( tr("Description:"), albumAnnotationFrame, "albumDescription" );
  albumDescriptionVal = new QLineEdit( albumAnnotationFrame, "albumDescriptionVal" );
  connect( albumDescriptionVal, SIGNAL(textChanged( const QString&)),
           SLOT( storeAnnotations()) );
 
  albumAuthor = new QLabel( tr("Author:"), albumAnnotationFrame, "albumAuthor" );
  albumAuthorVal = new QLineEdit( albumAnnotationFrame, "albumAuthorVal" );
  connect( albumAuthorVal, SIGNAL(textChanged( const QString&)),
           SLOT( storeAnnotations()) );
  //------
  //subalbum annotations
  subalbumAnnotationFrame = new Q3Frame( mainFrame, "subalbumAnnotationFrame" );
  subalbumAnnotationFrame->setLineWidth(2);
  subalbumAnnotationFrame->setMidLineWidth(0);
  subalbumAnnotationFrame->setFrameStyle( Q3Frame::Panel | Q3Frame::Plain );
  subalbumAnnotationFrame->setPaletteForegroundColor( white );
  subalbumAnnotationFrame->setPaletteBackgroundColor( darkBlue );
 
  Q3Frame* subalbumImageFrame = new Q3Frame( subalbumAnnotationFrame, "subalbumImageFrame" );
  subalbumImage = new ALabel( subalbumImageFrame, "subalbumImage",
                                                    new QPixmap( QString(IMAGE_PATH)+"buttonIcons/removeImage.png") );
 
  connect( subalbumImage, SIGNAL(mouseRelease()),
                 this, SLOT(unsetSubalbumImage()) );
 
  subalbumName = new QLabel( tr("Collection Name:"), subalbumAnnotationFrame );
  subalbumNameVal = new QLineEdit( subalbumAnnotationFrame );
  connect( subalbumNameVal, SIGNAL(textChanged( const QString&)),
           SLOT( storeAnnotations()) );
 
  subalbumDescription = new QLabel( tr("Description:"), subalbumAnnotationFrame );
  subalbumDescriptionVal = new QLineEdit( subalbumAnnotationFrame );
  connect( subalbumDescriptionVal, SIGNAL(textChanged( const QString&)),
           SLOT( storeAnnotations()) );
  //--------------------------------------------------------------
  //Set fonts + colors
  QFont labelFont = albumName->font();
  labelFont.setWeight(QFont::Bold);
 
  albumName->setFont( labelFont );
  albumName->setPaletteForegroundColor( white );
  albumName->setPaletteBackgroundColor( darkBlue );
 
  albumNameVal->setFont( labelFont );
  albumNameVal->setPaletteForegroundColor( black );
  albumNameVal->setPaletteBackgroundColor( lightBlue );
  albumNameVal->setFrame ( false );
 
  albumDescription->setFont( labelFont );
  albumDescription->setPaletteForegroundColor( white );
  albumDescription->setPaletteBackgroundColor( darkBlue );
 
  albumDescriptionVal->setFont( labelFont );
  albumDescriptionVal->setPaletteForegroundColor( black );
  albumDescriptionVal->setPaletteBackgroundColor( lightBlue );
  albumDescriptionVal->setFrame ( false );
 
  albumAuthor->setFont( labelFont );
  albumAuthor->setPaletteForegroundColor( white );
  albumAuthor->setPaletteBackgroundColor( darkBlue );
 
  albumAuthorVal->setFont( labelFont );
  albumAuthorVal->setPaletteForegroundColor( black );
  albumAuthorVal->setPaletteBackgroundColor( lightBlue );
  albumAuthorVal->setFrame ( false );
 
  subalbumName->setFont( labelFont );
  subalbumName->setPaletteForegroundColor( white );
  subalbumName->setPaletteBackgroundColor( darkBlue );
 
  subalbumNameVal->setFont( labelFont );
  subalbumNameVal->setPaletteForegroundColor( black );
  subalbumNameVal->setPaletteBackgroundColor( lightBlue );
  subalbumNameVal->setFrame ( false );
 
  subalbumDescription->setFont( labelFont );
  subalbumDescription->setPaletteForegroundColor( white );
  subalbumDescription->setPaletteBackgroundColor( darkBlue );
 
  subalbumDescriptionVal->setFont( labelFont );
  subalbumDescriptionVal->setPaletteForegroundColor( black );
  subalbumDescriptionVal->setPaletteBackgroundColor( lightBlue );
  subalbumDescriptionVal->setFrame ( false );
  //--------------------------------------------------------------
  //place widgets in grids
  //------------------------
  //album annotations
  Q3GridLayout* albumImageGrid = new Q3GridLayout( albumImageFrame, 1, 1 );
  albumImageGrid->addWidget( albumImage, 0, 0 );
  albumImageGrid->setRowSpacing( 0, REP_IMAGE_HEIGHT );
 
  albumAnnotationGrid =      new Q3GridLayout( albumAnnotationFrame, 3, 3);
  albumAnnotationGrid->setMargin(WIDGET_SPACING);
  albumAnnotationGrid->setSpacing(WIDGET_SPACING);
 
  albumAnnotationGrid->addMultiCellWidget( albumImageFrame, 0, 2, 0, 0 );
 
  albumAnnotationGrid->addWidget          ( albumName, 0, 1, Qt::AlignLeft);
  albumAnnotationGrid->addWidget          ( albumDescription, 1, 1, Qt::AlignLeft);
  albumAnnotationGrid->addWidget          ( albumAuthor, 2, 1, Qt::AlignLeft);
 
  albumAnnotationGrid->setColStretch(2, 1);
  albumAnnotationGrid->addWidget( albumNameVal, 0, 2);
  albumAnnotationGrid->addWidget( albumDescriptionVal, 1, 2);
  albumAnnotationGrid->addWidget( albumAuthorVal, 2, 2);
  //------------------------
  //subalbum annotations
  Q3GridLayout* subalbumImageGrid = new Q3GridLayout( subalbumImageFrame, 1, 1 );
  subalbumImageGrid->addWidget( subalbumImage, 0, 0 );
  subalbumImageGrid->setRowSpacing( 0, REP_IMAGE_HEIGHT );
 
  subalbumAnnotationGrid = new Q3GridLayout( subalbumAnnotationFrame, 5, 5);
  subalbumAnnotationGrid->setMargin(WIDGET_SPACING);
  subalbumAnnotationGrid->setSpacing(WIDGET_SPACING);
 
  subalbumAnnotationGrid->addMultiCellWidget( subalbumImageFrame, 0, 2, 0, 0);
 
  subalbumAnnotationGrid->setRowStretch(2, 1);
  subalbumAnnotationGrid->addWidget          ( subalbumName, 0, 1, Qt::AlignLeft);
  subalbumAnnotationGrid->addWidget          ( subalbumDescription, 1, 1, Qt::AlignLeft);
 
  subalbumAnnotationGrid->setColStretch(2, 1);
  subalbumAnnotationGrid->addWidget( subalbumNameVal, 0, 2);
  subalbumAnnotationGrid->addWidget( subalbumDescriptionVal, 1, 2);
  //------------------------
  //place menu and album and subalbum annotations into main grid
  mainGrid =                       new Q3GridLayout( mainFrame, 1, 2);
  mainGrid->setMargin(WIDGET_SPACING);
  mainGrid->setSpacing(WIDGET_SPACING);
 
  mainGrid->addWidget          ( albumAnnotationFrame, 0, 0);
  mainGrid->setColStretch(0, 1);
 
  mainGrid->addWidget          ( subalbumAnnotationFrame, 0, 1);
  mainGrid->setColStretch(1, 1);
 
  Q3VBoxLayout* vb = new Q3VBoxLayout(this);
  this->layout()->setMenuBar( menu );
  vb->addWidget(mainFrame);
  //-----------------------------------------------
}

References about, aboutProgram(), albm, albumAnnotationFrame, albumAnnotationGrid, albumAuthor, albumAuthorVal, albumDescription, albumDescriptionVal, albumImage, albumName, albumNameVal, albumStatistics(), albumStats, busy, createTmpDir(), detectModifications, EXPORT_LARGE_IMAGES, EXPORT_SMALL_WEB_GALLERY, exportLargeImages(), exportSmallWebGallery(), file, Window::getConfig(), RecentAlbums::getMaxItems(), Configuration::getString(), Album::getTmpDir(), help(), helpMenu, helpWindow, IMAGE_PATH, RecentAlbums::insertEntry(), loadAlbum(), mainFrame, mainGrid, menu, NEW_ALBUM, newAlbum(), OPEN_ALBUM, openRecent, photoMenu, populateOpenRecentMenu(), quitApplication(), recentAlbums, refreshOpenRecentMenu(), REMOVE_DESCRIPTIONS, removeSelectedPhotoDesc(), REP_IMAGE_HEIGHT, REVERT_PHOTOS, REVERT_TO_SAVED_ALBUM, revertPhotos(), revertToSaved(), SAVE_ALBUM, saveAlbum(), SAVEAS_ALBUM, saveAsAlbum(), settings(), settingsWindow, storeAnnotations(), subalbumAnnotationFrame, subalbumAnnotationGrid, subalbumDescription, subalbumDescriptionVal, subalbumImage, subalbumName, subalbumNameVal, tmpDirErrorDesc, tmpDirErrorMessage, tools, unsetAlbumImage(), unsetSubalbumImage(), WIDGET_SPACING, and window.

~TitleWidget()

TitleWidget::~TitleWidget

(

)

Deletes stuff!

Definition at line 397 of file titleWidget.cpp.

{
  //delete old album
  delete albm;
  albm = NULL;
}

References albm.

Member Function Documentation

aboutClosed

void TitleWidget::aboutClosed ( )

slot

Frees about dialog once closed.

Definition at line 1234 of file titleWidget.cpp.

{
  delete about;
  about = NULL;
}

References about.

Referenced by aboutProgram().

aboutProgram

void TitleWidget::aboutProgram ( int mode = ABOUT )

slot

Pops up about dialog.

Definition at line 1196 of file titleWidget.cpp.

{
  //create window and center if not already present
  if(about == NULL)
  {
    about = new About(mode);
    connect( about, SIGNAL(closed()),
             this, SLOT(aboutClosed()));
    about->show();
    centerWindow(about);
  }
 
  about->raise();
  about->setActiveWindow();
}

References about, aboutClosed(), and centerWindow().

Referenced by WelcomeWindow::itemClicked(), and TitleWidget().

albumStatistics

void TitleWidget::albumStatistics ( )

privateslot

Pops up album statistics window.

Definition at line 1137 of file titleWidget.cpp.

{
  //create window and center if not already present
  if(albumStats == NULL)
  {
    albumStats = new AlbumStatistics(albm);
    connect( albumStats, SIGNAL(closed()),
           this, SLOT(albumStatisticsClosed()));
    albumStats->show();
    centerWindow(albumStats);
  }
 
  albumStats->raise();
  albumStats->setActiveWindow();
}

References albm, albumStatisticsClosed(), albumStats, and centerWindow().

Referenced by TitleWidget().

albumStatisticsClosed

void TitleWidget::albumStatisticsClosed ( )

slot

Frees album statistics dialog once closed.

Definition at line 1228 of file titleWidget.cpp.

{
  delete albumStats;
  albumStats = NULL;
}

References albumStats.

Referenced by albumStatistics().

clearOpenRecentMenu

void TitleWidget::clearOpenRecentMenu ( )

privateslot

Clears albums from open recent menu.

Definition at line 1365 of file titleWidget.cpp.

{
  //clear recent list
  recentAlbums.clearList();
  
  //refresh menu
  refreshOpenRecentMenu();
}

References RecentAlbums::clearList(), recentAlbums, and refreshOpenRecentMenu().

Referenced by populateOpenRecentMenu().

createTmpDir()

QString TitleWidget::createTmpDir ( QString albumPath = QString::null )

protected

Definition at line 1306 of file titleWidget.cpp.

{
  //if album path provided attempt to create tmp directory in there to
  //minimize cost of doing moves when saving album changes.
  //the other reasoning is that user will have hopefully provided enough
  //space for saving large files on directory where they previously saved,
  //so this minmizes the chance of running out of disk hopefully
  if(!albumPath.isNull())
  {
    QDir rootDir( albumPath );
    if(rootDir.exists( "tmp" ) || rootDir.mkdir( "tmp" ))
    return QDir::convertSeparators( albumPath + "/tmp" );
  }
 
  //otherwise create unique tmp dir under scratch dir user specified in preferences
  QDate date = QDate::currentDate();
  QTime time = QTime::currentTime();
  QString baseDir = window->getConfig()->getString( "loadSave", "tempImageDirectory" );
 
  QDir testPath(baseDir);
  if(!testPath.exists())
  {
    window->getConfig()->resetSetting( "loadSave", "tempImageDirectory" );
    baseDir = window->getConfig()->getString( "loadSave", "tempImageDirectory" );
  }
 
  QString tmpDir = QString("albumshaper_tmp%1%2%3%4%5%6%7").arg( date.year() ).arg( date.month() ).arg
                                  ( date.day() ).arg( time.hour() ).arg( time.minute() ).arg( time.second() ).arg( time.msec() );
 
  QDir rootDir( baseDir );
  if(rootDir.exists() && (rootDir.exists( tmpDir ) || rootDir.mkdir( tmpDir) ) )
  {
/*    AlertDialog alert( "tmpDir:", QDir::convertSeparators( QString("(" + baseDir + "/" + tmpDir ) ),
    "alertIcons/warning.png", this );
    alert.exec();
*/
    return QDir::convertSeparators( baseDir + "/" + tmpDir );
  }
  else
  {
//    cout << "ERROR!\n";
    return QString::null;
  }
}

References Window::getConfig(), Configuration::getString(), Configuration::resetSetting(), and window.

Referenced by loadAlbum(), newAlbum(), and TitleWidget().

dragEnterEvent()

void TitleWidget::dragEnterEvent ( QDragEnterEvent * e )

protected

Definition at line 1283 of file titleWidget.cpp.

{
  e->accept(true);
}

dropEvent()

void TitleWidget::dropEvent ( QDropEvent * e )

protected

Definition at line 1288 of file titleWidget.cpp.

{
  //force redraw so we don't see missing unpainted
  //region while we resize an image which takes a while.
  repaint(false);
  qApp->processEvents();
 
  //if the source is not the origanize icon view then ignore the event
  if(e->source() == NULL ||
     e->source()->parentWidget() != window->getLayout()->getSubalbum()->getPhotos())
    return;
  
  if( e->pos().x() < (width() / 2) )
    setAlbumImage();
  else
    setSubalbumImage();
}

References Window::getLayout(), SubalbumWidget::getPhotos(), LayoutWidget::getSubalbum(), setAlbumImage(), setSubalbumImage(), width, and window.

exportLargeImages

void TitleWidget::exportLargeImages ( )

privateslot

Export large images only to a new directory for printing purposes.

Definition at line 806 of file titleWidget.cpp.

{
  //setup dialog title and default path
  QString dialogTitle = tr( "Export Large Images" );
 
  //new directory name in which all images will be contained
  QString newDir;
  if(getAlbum()->prevSave())
  { newDir = QDir( getAlbum()->getSaveLocation() ).dirName() + "_IMAGES"; }
  else
  { newDir = getAlbum()->getName() + "_IMAGES"; }
  newDir = fixFilename( newDir );
  
  //get filename from user
  Q3FileDialog* fd = new Q3FileDialog( this, "file dialog", TRUE );
  fd->setCaption( tr("Export Location") );
  fd->setMode( Q3FileDialog::DirectoryOnly );
  fd->setDir( window->getConfig()->getString( "loadSave", "loadSaveDir" ) );
  
  //user canceled operation
  if ( !fd->exec() == QDialog::Accepted ) { return; }
 
  //get export path
  QString exportPath = QDir::convertSeparators( fd->selectedFile() + "/" + newDir );
 
  //check to make sure the album is not in this location, if so raise red flag and abort!!
  if( getAlbum()->prevSave() && getAlbum()->getSaveLocation().compare( exportPath ) == 0 )
  {
    QString errorMessage = tr("Error! Cannot export to album location on disk!");
    QString errorDesc = tr("Exporting large images to the same location the album is stored will corrupt it and is not allowed. Try using the default location when exporting images, or chose a different directory.");
    AlertDialog alert( errorMessage, errorDesc,
                       "alertIcons/warning.png", this );
    alert.exec();
    return;
  }
 
  //otherwise check if directory already exists, if so warn user and ask before proceeding
  QDir tmpDir;
  if(tmpDir.exists( exportPath ) )
  {
    QString warningMessage = 
    QString(tr("Warning! A directory named %1 already exists in %2. Continue with export?")).arg
    ( newDir ).arg( fd->selectedFile() );
    
    QuestionDialog sure( tr("Directory Exists!"),
                         warningMessage, "alertIcons/warning.png",
                         this );
    if(!sure.exec()) { return; }
  }    
  //else create directory
  else
  {
    if( !tmpDir.mkdir( exportPath ) )
    {
      AlertDialog alert( tr("Error creating directory!"),
                         tr("Unable to create directory to export images to.Perhaps you are running out of disk space or you don't have sufficient privileges?"),
                           "alertIcons/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));
 
  //setup progress bar
  int numPhotos = getAlbum()->getNumPhotos();  
  QString exportMessage = tr( "Exporting %1 photos" );
  window->getStatus()->showProgressBar( exportMessage.arg(numPhotos), numPhotos );
  qApp->processEvents();
  
  //export large images
  getAlbum()->exportLargeImages(window->getStatus(), exportPath, exportMessage);  
 
  //remove progress bar
  window->getStatus()->setStatus( tr("Exporting photos complete.") );
 
  //nolonger busy
  setBusy(false);
  window->getLayout()->getSubalbums()->updateButtons(true);
  if(window->getLayout()->getSubalbum() != NULL)
    window->getLayout()->getSubalbum()->updateButtons(true);
  qApp->restoreOverrideCursor();
}

References Album::exportLargeImages(), fixFilename(), getAlbum(), Window::getConfig(), Window::getLayout(), Album::getName(), Album::getNumPhotos(), Window::getStatus(), Configuration::getString(), LayoutWidget::getSubalbum(), LayoutWidget::getSubalbums(), setBusy(), StatusWidget::setStatus(), StatusWidget::showProgressBar(), SubalbumsWidget::updateButtons(), SubalbumWidget::updateButtons(), and window.

Referenced by TitleWidget().

exportSmallWebGallery

void TitleWidget::exportSmallWebGallery ( )

privateslot

Export small web gallery (excludes full size images and Album.xml file)

Definition at line 706 of file titleWidget.cpp.

{
  //if the Album's theme is not currently available alert user and bail
  if(!SaveDialog::themeAvailable( getAlbum()->getTheme() ))
  {
    AlertDialog alert( tr("Previous theme not available!"),
                       QString(tr("Theme previously used to save this album not available on this machine. Before exporting the %1 theme must be installed, or the album must be resaved using a different theme.")).arg( getAlbum()->getTheme() ),
                        "alertIcons/warning.png", this );
    alert.exec();
    return;
  }
  
  
  //setup dialog title and default path
  QString dialogTitle = tr( "Export Small Web Gallery" );
  
  //new directory name in which all images will be contained
  QString newDir;
  if(getAlbum()->prevSave())
  { newDir = QDir( getAlbum()->getSaveLocation() ).dirName() + "_WEB"; }
  else
  { newDir = getAlbum()->getName() + "_WEB"; }
  newDir = fixFilename( newDir );
  
  //get filename from user
  Q3FileDialog* fd = new Q3FileDialog( this, "file dialog", TRUE );
  fd->setCaption( tr("Export Location") );
  fd->setMode( Q3FileDialog::DirectoryOnly );
  fd->setDir( window->getConfig()->getString( "loadSave", "loadSaveDir" ) );
  
  //user canceled operation
  if ( !fd->exec() == QDialog::Accepted ) { return; }
  
  //get export path
  QString exportPath = QDir::convertSeparators( fd->selectedFile() + "/" + newDir );
  
  //check to make sure the album is not in this location, if so raise red flag and abort!!
  if( getAlbum()->prevSave() && getAlbum()->getSaveLocation().compare( exportPath ) == 0 )
  {
    QString errorMessage = tr("Error! Cannot export to album location on disk!");
    QString errorDesc = tr("Exporting small web galleries to the same location the album is stored will corrupt it and is not allowed. Try using the default location when exporting images, or chose a different directory.");
    AlertDialog alert( errorMessage, errorDesc,
                       "alertIcons/warning.png", this );
    alert.exec();
    return;
  }
  
  //otherwise check if directory already exists, if so warn user and ask before proceeding
  QDir tmpDir;
  if(tmpDir.exists( exportPath ) )
  {
    QString warningMessage = 
    QString(tr("Warning! A directory named %1 already exists in %2. Continue with export?")).arg
    ( newDir ).arg( fd->selectedFile() );
    
    QuestionDialog sure( tr("Directory Exists!"),
                         warningMessage, "alertIcons/warning.png",
                         this );
    if(!sure.exec()) { return; }
  }    
  //else create directory
  else
  {
    if( !tmpDir.mkdir( exportPath ) )
    {
      AlertDialog alert( tr("Error creating directory!"),
                         tr("Unable to create directory to export images to. Perhaps you are running out of disk space or you don't have sufficient privileges?"),
                         "alertIcons/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));
  
  //setup progress bar
  int numPhotos = getAlbum()->getNumPhotos();  
  QString exportMessage = tr( "Exporting %1 photos to web gallery" );
  window->getStatus()->showProgressBar( exportMessage.arg(numPhotos), numPhotos );
  qApp->processEvents();
  
  //export large images
  getAlbum()->exportCompressedWebAlbum(window->getStatus(), exportPath, exportMessage);  
  
  //remove progress bar
  window->getStatus()->setStatus( tr("Exporting photos complete.") );
  
  //nolonger busy
  setBusy(false);
  window->getLayout()->getSubalbums()->updateButtons(true);
  if(window->getLayout()->getSubalbum() != NULL)
    window->getLayout()->getSubalbum()->updateButtons(true);
  qApp->restoreOverrideCursor();
}

References Album::exportCompressedWebAlbum(), fixFilename(), getAlbum(), Window::getConfig(), Window::getLayout(), Album::getName(), Album::getNumPhotos(), Window::getStatus(), Configuration::getString(), LayoutWidget::getSubalbum(), LayoutWidget::getSubalbums(), setBusy(), StatusWidget::setStatus(), StatusWidget::showProgressBar(), SaveDialog::themeAvailable(), SubalbumsWidget::updateButtons(), SubalbumWidget::updateButtons(), and window.

Referenced by TitleWidget().

getAlbum()

Album * TitleWidget::getAlbum

(

)

Returns a pointer to the album object.

Definition at line 493 of file titleWidget.cpp.

{
  return albm;
}

References albm.

Referenced by Window::closeEvent(), SubalbumsWidget::createAction(), SubalbumsWidget::deleteAction(), exportLargeImages(), exportSmallWebGallery(), SubalbumsWidget::refreshCollectionsList(), SubalbumsWidget::reorder(), saveAlbum(), and saveAsAlbum().

getBusy()

bool TitleWidget::getBusy

(

)

is program busy?

Definition at line 1252 of file titleWidget.cpp.

{
  return busy;
}

References busy.

Referenced by SubalbumsWidget::handleSelectionAttempt().

getRecentAlbums()

RecentAlbums * TitleWidget::getRecentAlbums

(

)

returns handle to recent albums object

Definition at line 1546 of file titleWidget.cpp.

{
  return &recentAlbums; 
}

References recentAlbums.

Referenced by Window::~Window().

help

void TitleWidget::help ( )

slot

Pops up HelpWindow.

Definition at line 1212 of file titleWidget.cpp.

{
  //create window and center if not already present
  if(helpWindow == NULL)
  {
    helpWindow = new HelpWindow(0);
    connect( helpWindow, SIGNAL(closed()),
             this, SLOT(helpClosed()));
    helpWindow->show();
    centerWindow(helpWindow);
  }
 
  helpWindow->raise();
  helpWindow->setActiveWindow();
}

References centerWindow(), helpClosed(), and helpWindow.

Referenced by WelcomeWindow::itemClicked(), and TitleWidget().

helpClosed

void TitleWidget::helpClosed ( )

slot

Frees HelpWindow once closed.

Definition at line 1240 of file titleWidget.cpp.

{
  delete helpWindow;
  helpWindow = NULL;
}

References helpWindow.

Referenced by help().

loadAlbum [1/2]

void TitleWidget::loadAlbum ( )

privateslot

Loads an album specified with file chooser.

make sure we want to proceed

Definition at line 627 of file titleWidget.cpp.

{
  if(!proceedWithLoad())
    return;
 
  QString path = window->getConfig()->getString( "loadSave", "loadSaveDir" );
  QDir testPath(path);
  if(!testPath.exists())
  {
    window->getConfig()->resetSetting( "loadSave", "loadSaveDir" );
    path = window->getConfig()->getString( "loadSave", "loadSaveDir" );
  }
  
  QString albumXML = Q3FileDialog::getOpenFileName( path,
                                                   tr("XML Files (*.xml)"),
                                                   this,
                                                   "open file dialog",
                                                   tr("Choose an album to load") );
  
  //if null bail
  if(albumXML.isNull()) return;
  
  //attempt to load album
  loadAlbum( albumXML );    
}  

References Window::getConfig(), Configuration::getString(), loadAlbum(), proceedWithLoad(), Configuration::resetSetting(), and window.

Referenced by loadAlbum(), loadRecentAlbum(), revertToSaved(), and TitleWidget().

loadAlbum [2/2]

void TitleWidget::loadAlbum ( QString location )

privateslot

Loads a specified album.

Definition at line 895 of file titleWidget.cpp.

{
  //disable user input
  window->getStatus()->grabInput();
  
  //enable busy cursor, set busy flag, and deactivate buttons
  qApp->setOverrideCursor( QCursor(Qt::WaitCursor));
  setBusy(true);
  window->getLayout()->getSubalbums()->updateButtons(false);
  if(window->getLayout()->getSubalbum() != NULL)
    window->getLayout()->getSubalbum()->updateButtons(false);
 
  //store load/save location
  QDir lastDir = QDir( QFileInfo(albumXML).dirPath() );
  lastDir.cdUp();
  window->getConfig()->setString( "loadSave", "loadSaveDir", lastDir.path() );
 
  //create a new album (with no subalbums, hense false)
  delete albm;
 
  albm = new Album( createTmpDir( QFileInfo(albumXML).dirPath() ), false );
  if(albm->getTmpDir().isNull() )
  {
      AlertDialog alert( tmpDirErrorMessage, tmpDirErrorDesc + window->getConfig()->getString( "loadSave", "tempImageDirectory" ),
      "alertIcons/warning.png", this );
      alert.exec();
      quitApplication();
  }
 
  //attempt to load xml file
  int errorCode = albm->importFromDisk(window->getStatus(), albumXML,
                                       window->getConfig()->getBool( "loadSave", "disableCheckPhotoMods" ) );
 
  //if no subalbums in album then hide subalbum annotations
  if(albm->getFirstSubalbum() == NULL)
  {
    subalbumAnnotationFrame->hide();
    subalbumImage->removePixmap(true);
  }
  
  //reset editing interface since old pointers are invalid
  window->getLayout()->getSubalbum()->setSubalbum( NULL );
  refresh();
 
  //set album as not modified
  albm->setModified(false);
    
  //update recent albums listing
  recentAlbums.insertEntry( albm->getName(), albm->getSaveLocation(), 
                           QString("%1").arg(albm->getNumPhotos()), false );
  refreshOpenRecentMenu();  
  
  //nolonger busy
  qApp->restoreOverrideCursor();
  setBusy(false);
  window->getLayout()->getSubalbums()->updateButtons(true);
  if(window->getLayout()->getSubalbum() != NULL)
    window->getLayout()->getSubalbum()->updateButtons(true);
 
  //enable user input
  window->getStatus()->releaseInput(); 
  
  //load successful
  if(errorCode == ALBUM_LOADED)
  {
    //enable "revert" menu option
    file->setItemEnabled( REVERT_TO_SAVED_ALBUM, true );    
 
    //update presentation command based on if there are photos in this album
    updateMenus();
  }
  //else display appropriate error message
  else
  {  
    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, "alertIcons/warning.png", this );
    alert.exec();
  }
}

References albm, ALBUM_LOADED, ALBUM_READ_ERROR, ALBUM_XML_ERROR, createTmpDir(), file, Configuration::getBool(), Window::getConfig(), Album::getFirstSubalbum(), Window::getLayout(), Album::getName(), Album::getNumPhotos(), Album::getSaveLocation(), Window::getStatus(), Configuration::getString(), LayoutWidget::getSubalbum(), LayoutWidget::getSubalbums(), Album::getTmpDir(), StatusWidget::grabInput(), Album::importFromDisk(), RecentAlbums::insertEntry(), quitApplication(), recentAlbums, refresh(), refreshOpenRecentMenu(), StatusWidget::releaseInput(), ALabel::removePixmap(), REVERT_TO_SAVED_ALBUM, setBusy(), Album::setModified(), Configuration::setString(), SubalbumWidget::setSubalbum(), subalbumAnnotationFrame, subalbumImage, tmpDirErrorDesc, tmpDirErrorMessage, SubalbumsWidget::updateButtons(), SubalbumWidget::updateButtons(), updateMenus(), and window.

loadRecentAlbum

void TitleWidget::loadRecentAlbum ( int index )

privateslot

Loads a recent album.

make sure we want to proceed

Definition at line 654 of file titleWidget.cpp.

{
  if(!proceedWithLoad())
    return;
  //load album
  QString recentName, recentLocation, recentPhotoCount;
  recentAlbums.getEntry( index, recentName, recentLocation, recentPhotoCount );
  loadAlbum( QDir::convertSeparators( recentLocation + "/Album.xml") );             
}

References RecentAlbums::getEntry(), loadAlbum(), proceedWithLoad(), and recentAlbums.

Referenced by populateOpenRecentMenu().

newAlbum

void TitleWidget::newAlbum ( )

privateslot

Resets to empty album.

Definition at line 585 of file titleWidget.cpp.

{
  //if modifications exist and user wants to receive destructive action warnings,
  //ask if they are sure before creating a new album
  if( albm->albumModified() && window->getConfig()->getBool( "alerts", "showDestructiveAlerts" ) )
  {
    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?"),
                                   "alertIcons/warning.png",
                                   this );
    if(!sure.exec())
      return;
  }
 
  //delete old album
  delete albm;
 
  //create new one
  albm = new Album( createTmpDir() );
  
  if(albm->getTmpDir().isNull() )
  {
      AlertDialog alert( tmpDirErrorMessage, tmpDirErrorDesc + window->getConfig()->getString( "loadSave", "tempImageDirectory" ),
      "alertIcons/warning.png", this );
      alert.exec();
      quitApplication();
  }
 
  //refresh screen
  albumImage->removePixmap();
  subalbumImage->removePixmap(true);
 
  //disable revert menu option since there is no loaded album
  file->setItemEnabled( REVERT_TO_SAVED_ALBUM, false );  
  
  //reset editing interface since old pointers are invalid
  window->getLayout()->getSubalbum()->setSubalbum( NULL );
  refresh();
 
  albm->setModified(false);
}

References albm, albumImage, Album::albumModified(), createTmpDir(), file, Configuration::getBool(), Window::getConfig(), Window::getLayout(), Configuration::getString(), LayoutWidget::getSubalbum(), Album::getTmpDir(), quitApplication(), refresh(), ALabel::removePixmap(), REVERT_TO_SAVED_ALBUM, Album::setModified(), SubalbumWidget::setSubalbum(), subalbumImage, tmpDirErrorDesc, tmpDirErrorMessage, and window.

Referenced by TitleWidget().

populateOpenRecentMenu()

void TitleWidget::populateOpenRecentMenu ( )

private

Populates the open recent menu with a default set of 9 items + clear.

Definition at line 1374 of file titleWidget.cpp.

{
  int maxItems = recentAlbums.getMaxItems();
  numRecentMenuItems = maxItems + 2; //+2 for seperator and clear entry
  recentMenuItems = new int[numRecentMenuItems];
  customRecentMenuItems = new RecentAlbumMenuItem*[maxItems];
  
  //insert recent albums into menu
  int i;
  for(i = 0; i<maxItems; i++)
  {
    Qt::Key key;
    if(i == 0) key = Qt::Key_1;
    else if(i == 1) key = Qt::Key_2;
    else if(i == 2) key = Qt::Key_3;
    else if(i == 3) key = Qt::Key_4;
    else if(i == 4) key = Qt::Key_5;
    else if(i == 5) key = Qt::Key_6;
    else if(i == 6) key = Qt::Key_7;
    else if(i == 7) key = Qt::Key_8;
    else if(i == 8) key = Qt::Key_9;
    else key = Qt::Key_unknown;
    
    //get album name + location
    QString recentName = "recentName";
    QString recentLocation = "recentLocation";
    QString recentPhotoCount = "recentPhotoCount";
    
    //----------------------------------------------    
    //PLATFORM_SPECIFIC_CODE
#if defined(Q_OS_MACX)
    //Mac OS X does not support custom painted system menu entries. :(
    recentMenuItems[i] = openRecent->insertItem( "uninitialized recent album",
                                         this, SLOT(loadRecentAlbum(int)) );  
    //----------------------------------------------    
    //Under other operating systems (Windows, Linux, FreeBSD) use custom recent album menu item 
    //such that album image is larger and more detail is provided
#else  
    customRecentMenuItems[i] = new RecentAlbumMenuItem(key);
    recentMenuItems[i] = openRecent->insertItem( customRecentMenuItems[i] );
    openRecent->connectItem( recentMenuItems[i], this, SLOT(loadRecentAlbum(int)) );
#endif   
    //----------------------------------------------         
    //Set accelerator key sequence if valid    
    if( key != Qt::Key_unknown )
    {
      openRecent->setAccel( Qt::CTRL+key, recentMenuItems[i] ); 
      openRecent->setItemParameter( recentMenuItems[i], i );
    }
 
    //hide + disable entry
    openRecent->setItemVisible( recentMenuItems[i], false );    
    openRecent->setItemEnabled( recentMenuItems[i], false );      
    //----------------------------------------------         
  }
  
  //insert separator and "clear menu" entry.
  recentMenuItems[numRecentMenuItems-2] = openRecent->insertSeparator();
  recentMenuItems[numRecentMenuItems-1] = openRecent->insertItem( tr("Clear Menu"), 
                                                                  this, 
                                                                  SLOT(clearOpenRecentMenu()) );  
  
  //hide separtor, disable clear entry
  openRecent->setItemVisible( recentMenuItems[numRecentMenuItems-2], false );    
  openRecent->setItemEnabled( recentMenuItems[numRecentMenuItems-1], false );      
}

References clearOpenRecentMenu(), customRecentMenuItems, RecentAlbums::getMaxItems(), loadRecentAlbum(), numRecentMenuItems, openRecent, recentAlbums, and recentMenuItems.

Referenced by TitleWidget().

proceedWithLoad

bool TitleWidget::proceedWithLoad ( )

privateslot

Helper function for load methods, checks if there are any unsaved changes and if so warns user any such changes will be lost if they proceed.

Definition at line 665 of file titleWidget.cpp.

{
  //if modifications exist and user wants to receive destructive action warnings,
  //ask if they are sure before creating a new album
  if( albm->albumModified() && window->getConfig()->getBool( "alerts", "showDestructiveAlerts" ) )
  {
    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?"),
                         "alertIcons/warning.png",
                         this );
    if(!sure.exec())
      return false;
  }  
  
  return true;
}

References albm, Album::albumModified(), Configuration::getBool(), Window::getConfig(), and window.

Referenced by loadAlbum(), and loadRecentAlbum().

quitApplication

void TitleWidget::quitApplication ( )

slot

Quit slot.

Definition at line 1278 of file titleWidget.cpp.

{
  window->close();
}

References window.

Referenced by loadAlbum(), newAlbum(), and TitleWidget().

refresh()

void TitleWidget::refresh

(

)

Refreshs data from backend objects.

Definition at line 572 of file titleWidget.cpp.

{
  //first refresh the subalbums listing. this is 
  //IMPERATIVE! Right now current subalbum selection contains a pointer
  //to dead memory where previous subalbum was deleted. 
  //AKA not refreshing the subalbums iconview first will cause a crash!
  window->refresh();
 
  //update the album annotations (name, desc, author, images)
  //subalbum auto updated since window refresh auto selected first item
  updateAlbumAnnotations();
}

References Window::refresh(), updateAlbumAnnotations(), and window.

Referenced by loadAlbum(), and newAlbum().

refreshCollectionAnnotations

void TitleWidget::refreshCollectionAnnotations ( Subalbum * collection )

slot

Update displayed collection name and cover image.

Definition at line 455 of file titleWidget.cpp.

{
  //disable modification detection while updating fields
  detectModifications = false;
 
  //get subalbum pointer
  if( collection == NULL )
  {
    subalbumAnnotationFrame->hide();
    subalbumImage->removePixmap(true);
  }
  else
  {
    subalbumAnnotationFrame->show();
 
    //if no image then remove pixmap
    if( collection->getRepresentativeImage(LARGE) != NULL)
      subalbumImage->setPixmap( *collection->getRepresentativeImage(SMALL) );
    else
      subalbumImage->removePixmap();
 
    subalbumNameVal->setText( collection->getName() );
    subalbumNameVal->setCursorPosition(0);
    subalbumDescriptionVal->setText( collection->getDescription() );
    subalbumDescriptionVal->setCursorPosition(0);
  }
 
  //enable modification detection
  detectModifications = true;
}

References detectModifications, Subalbum::getDescription(), Subalbum::getName(), Subalbum::getRepresentativeImage(), LARGE, ALabel::removePixmap(), ALabel::setPixmap(), SMALL, subalbumAnnotationFrame, subalbumDescriptionVal, subalbumImage, and subalbumNameVal.

refreshOpenRecentMenu()

void TitleWidget::refreshOpenRecentMenu ( )

private

Refreshes open recent menu.

Definition at line 1441 of file titleWidget.cpp.

{
  //update text, visibility, and enabled bit for all items in list
  int i;
 
#ifndef Q_OS_MACX
  int maxWidth=0;
#endif
 
  for(i=0; i<numRecentMenuItems; i++)
  {
    //----------------------------------------------    
    //item - update fields, enable, and show
    QString recentName, recentLocation, recentPhotoCount;
    QDir tempDir;
    if( i < recentAlbums.numEntries())
    {
      //get album name + location
      recentAlbums.getEntry( i, recentName, recentLocation, recentPhotoCount );
      //----------------------------------------------    
      //PLATFORM_SPECIFIC_CODE
      //Mac OS X does not support custom painted system menu entries. :(
#if defined(Q_OS_MACX)
      QString albumImageLocation = QDir::convertSeparators( recentLocation + "/img/album.jpg" );
      
      //don't display photo count if not available (-1)
      if(recentPhotoCount.compare("-1") == 0)
        recentPhotoCount = "";
      else
        recentPhotoCount = " (" + recentPhotoCount + ")";
      
      //if album image exits resize it and use for menu item icon
      if( tempDir.exists( albumImageLocation ) )
      {
        //scale image
        QImage scaledAlbumImage;
        scaleImage( albumImageLocation, scaledAlbumImage, 32, 32 );
        
        //use text and pixmap
        QPixmap scaledAlbumImagePixmap;
        scaledAlbumImagePixmap.convertFromImage( scaledAlbumImage );
        
        openRecent->changeItem( recentMenuItems[i],
                                QIcon( scaledAlbumImagePixmap ),
                                QString("%1%2").arg(recentName).arg(recentPhotoCount) );
      }      
      //otherwise simply display the album name and number of phots (if available)
      else
      {
        //using just text
        openRecent->changeItem( recentMenuItems[i],
                                QIcon(NULL),
                                QString("%1%2").arg(recentName).arg(recentPhotoCount) );
      }
      //----------------------------------------------    
      //Under other operating systems (Windows, Linux, FreeBSD) use custom recent album menu item 
      //such that album image is larger and more detail is provided
#else  
      customRecentMenuItems[i]->changeItem( recentName, recentLocation, recentPhotoCount );                                           
      maxWidth = QMAX( maxWidth, customRecentMenuItems[i]->sizeHint().width() );
#endif   
      //----------------------------------------------         
      openRecent->setItemEnabled( recentMenuItems[i], true );      
      openRecent->setItemVisible( recentMenuItems[i], true );    
      
      //if the Album.xml file is unavailable then disable menu entry
      if( !tempDir.exists( QDir::convertSeparators(recentLocation + "/Album.xml") ) )
        openRecent->setItemEnabled( recentMenuItems[i], false );    
    }
    //----------------------------------------------         
    //hidden item - disable and hide
    else if( i >= recentAlbums.numEntries() &&
             i < numRecentMenuItems-2 )
    {
      openRecent->setItemEnabled( recentMenuItems[i], false );      
      openRecent->setItemVisible( recentMenuItems[i], false );    
    }
    //----------------------------------------------         
    //separtor - show if one or more items in list
    else if (i == numRecentMenuItems-2)
    {
      openRecent->setItemVisible( recentMenuItems[numRecentMenuItems-2], 
                                  recentAlbums.numEntries() > 0 );    
    }
    //----------------------------------------------         
    //clear items - enable if items in list
    else if (i == numRecentMenuItems-1)
    {
      openRecent->setItemEnabled( recentMenuItems[numRecentMenuItems-1], 
                                  recentAlbums.numEntries() > 0 );    
    }
    //----------------------------------------------         
  }
 
 
  //pass over custom menu items a second time letting them know the maximum item width
#ifndef Q_OS_MACX
  for(i=0; i<recentAlbums.numEntries(); i++)
  {
    customRecentMenuItems[i]->setMaxWidth( maxWidth );
  }
#endif
 
}

References RecentAlbumMenuItem::changeItem(), customRecentMenuItems, RecentAlbums::getEntry(), RecentAlbums::numEntries(), numRecentMenuItems, openRecent, recentAlbums, recentMenuItems, scaleImage(), RecentAlbumMenuItem::setMaxWidth(), and width.

Referenced by clearOpenRecentMenu(), loadAlbum(), saveAlbum(), saveAsAlbum(), and TitleWidget().

removeSelectedPhotoDesc

void TitleWidget::removeSelectedPhotoDesc ( )

privateslot

Strip descriptions from selected photos.

Definition at line 1153 of file titleWidget.cpp.

{
  //if no subalbum or photos selected ignore command
  if(window->getLayout()->getSubalbum() == NULL ||
     !window->getLayout()->getSubalbum()->anyPhotosSelected())
     return;
 
  //ask user if they are sure they want to remove selected photo descriptions
  if( window->getConfig()->getBool( "alerts", "showDestructiveAlerts" ) )
  {
    QuestionDialog sure( tr("Remove Selected Photo Descriptions?"),
                                   tr("This action cannot be undone. Are you sure you want to proceed?"),
                                   "alertIcons/warning.png",
                                   this );
    if(!sure.exec())
      return;
  }
 
  //proceed with stripping of photo descriptions
  window->getLayout()->getSubalbum()->stripDescriptionsFromSelectedPhotos();
}

References SubalbumWidget::anyPhotosSelected(), Configuration::getBool(), Window::getConfig(), Window::getLayout(), LayoutWidget::getSubalbum(), SubalbumWidget::stripDescriptionsFromSelectedPhotos(), and window.

Referenced by TitleWidget().

revertPhotos

void TitleWidget::revertPhotos ( )

privateslot

Revert selected photos to original form.

Definition at line 1175 of file titleWidget.cpp.

{  
  window->getLayout()->revertPhotos();
}

References Window::getLayout(), LayoutWidget::revertPhotos(), and window.

Referenced by TitleWidget().

revertToSaved

void TitleWidget::revertToSaved ( )

privateslot

Revert to last saved album.

make sure we want to proceed

Definition at line 682 of file titleWidget.cpp.

{
  //if there are no changed then immediately return since reverting will have no effect
  //TODO: disable "revert" menu entry when no modifications exist
  if( !albm->albumModified() )
    return;
  
  //if modifications exist and user wants to receive destructive action warnings,
  //ask if they are sure before creating a new album
  if( window->getConfig()->getBool( "alerts", "showDestructiveAlerts" ) )
  {
    QuestionDialog sure( tr("Revert to Saved?"),
                         tr("Warning, unsaved modifications to the current album exist. These changes will be lost if you revert to the album's last saved form. Are you sure you want to do this?"),
                         "alertIcons/warning.png",
                         this );
    if(!sure.exec())
      return;
  }    
  
  //reload album
  loadAlbum( QDir::convertSeparators( albm->getSaveLocation() + "/Album.xml") );  
}

References albm, Album::albumModified(), Configuration::getBool(), Window::getConfig(), Album::getSaveLocation(), loadAlbum(), and window.

Referenced by TitleWidget().

saveAlbum

void TitleWidget::saveAlbum ( )

privateslot

Saves album.

Definition at line 991 of file titleWidget.cpp.

{
  //if album not previously saved then
  //run saveas dialog
  if(!getAlbum()->prevSave())
  {
    saveAsAlbum();
    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."),
                            "alertIcons/warning.png", this );
    alert.exec();
    saveAsAlbum();
    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));
 
  getAlbum()->exportToDisk(window->getStatus());
 
  window->getConfig()->setString( "loadSave", "lastUsedTheme",  getAlbum()->getTheme() );
 
  //update recent albums listing
  recentAlbums.insertEntry( albm->getName(), albm->getSaveLocation(), 
                            QString("%1").arg(albm->getNumPhotos()), false );
  refreshOpenRecentMenu();  
 
  //enable revert command since saved album now exists
  file->setItemEnabled( REVERT_TO_SAVED_ALBUM, true );    
  
  //nolonger busy
  setBusy(false);
  window->getLayout()->getSubalbums()->updateButtons(true);
  if(window->getLayout()->getSubalbum() != NULL)
    window->getLayout()->getSubalbum()->updateButtons(true);
  qApp->restoreOverrideCursor();
}

References albm, Album::exportToDisk(), file, getAlbum(), Window::getConfig(), Window::getLayout(), Album::getName(), Album::getNumPhotos(), Album::getSaveLocation(), Window::getStatus(), LayoutWidget::getSubalbum(), LayoutWidget::getSubalbums(), RecentAlbums::insertEntry(), recentAlbums, refreshOpenRecentMenu(), REVERT_TO_SAVED_ALBUM, saveAsAlbum(), setBusy(), Configuration::setString(), SaveDialog::themeAvailable(), SubalbumsWidget::updateButtons(), SubalbumWidget::updateButtons(), and window.

Referenced by TitleWidget().

saveAsAlbum

void TitleWidget::saveAsAlbum ( )

privateslot

Saves album as.

Definition at line 1040 of file titleWidget.cpp.

{
  //setup dialog title and default path
  QString dialogTitle = tr( "Save As" );
  QString defaultPath;
 
  if(getAlbum()->prevSave())
    defaultPath = getAlbum()->getSaveLocation();
  else
  {
    defaultPath = getAlbum()->getName();
    defaultPath.replace( QChar(' '), "_" );
    defaultPath.replace( "<", "" );
    defaultPath.replace( ">", "" );
    defaultPath.replace( "&", "and" );
    defaultPath.replace( "\"", "" );
    defaultPath.replace( "\'", "" );
    defaultPath.replace( "?", "" );
    defaultPath = QDir::convertSeparators
       ( window->getConfig()->getString( "loadSave", "loadSaveDir" ) + "/" + defaultPath );
  }
 
  //get directory name in which album directory will be placed in
  QString theme, savePath;
 
  //if abum saved before then auto select last used theme
  if(getAlbum()->getTheme().compare("-1") != 0)
    theme = getAlbum()->getTheme();
  else
  {
    if(window->getConfig()->getString( "loadSave", "defaultTheme" ).compare( "Last Used" ) == 0)
      theme = window->getConfig()->getString( "loadSave", "lastUsedTheme" );
    else
      theme = window->getConfig()->getString( "loadSave", "defaultTheme" );
  }
 
  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 privileges?"),
                              "alertIcons/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 privileges?"),
                              "alertIcons/warning.png", this );
      alert.exec();
      return;
    }
  }
 
  //store this load/Save location
  QDir lastDir = QDir( savePath );
  lastDir.cdUp();
  window->getConfig()->setString( "loadSave", "loadSaveDir", lastDir.path() );
  window->getConfig()->setString( "loadSave", "lastUsedTheme",  theme );
 
  //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));
 
  //save
  getAlbum()->exportToDisk(window->getStatus(), savePath, theme);
  window->getConfig()->setString( "misc", "defaultAuthor", albumAuthorVal->text() );
 
  //update recent albums listing
  recentAlbums.insertEntry( albm->getName(), albm->getSaveLocation(), 
                            QString("%1").arg(albm->getNumPhotos()), false );
  refreshOpenRecentMenu();  
  
  //enable revert command since saved album now exists
  file->setItemEnabled( REVERT_TO_SAVED_ALBUM, true );    
  
  //nolonger busy
  setBusy(false);
  window->getLayout()->getSubalbums()->updateButtons(true);
  if(window->getLayout()->getSubalbum() != NULL)
    window->getLayout()->getSubalbum()->updateButtons(true);
  qApp->restoreOverrideCursor();
}

References albm, albumAuthorVal, Album::exportToDisk(), file, getAlbum(), Window::getConfig(), Window::getLayout(), Album::getName(), Album::getNumPhotos(), Album::getSaveLocation(), Window::getStatus(), Configuration::getString(), LayoutWidget::getSubalbum(), LayoutWidget::getSubalbums(), Album::getTheme(), RecentAlbums::insertEntry(), recentAlbums, refreshOpenRecentMenu(), REVERT_TO_SAVED_ALBUM, SaveDialog::selectThemeAndPath(), setBusy(), Configuration::setString(), SubalbumsWidget::updateButtons(), SubalbumWidget::updateButtons(), and window.

Referenced by saveAlbum(), and TitleWidget().

setAlbum()

void TitleWidget::setAlbum

(

Album *

val

)

Sets new pointer to the album object.

Definition at line 486 of file titleWidget.cpp.

{
  //delete old album
  delete albm;
  albm = val;
}

References albm.

setAlbumImage [1/2]

void TitleWidget::setAlbumImage ( )

privateslot

Sets the Album Image.

Definition at line 498 of file titleWidget.cpp.

{
  //---------------------------------------------------------
  //determine if a subalbum is even selected
  SubalbumWidget* sw = window->getLayout()->getSubalbum();
  if(sw == NULL)
    return;
  //---------------------------------------------------------
  //set image to photo
  setAlbumImage( sw->getSelectedPhoto() );
}

References Window::getLayout(), SubalbumWidget::getSelectedPhoto(), LayoutWidget::getSubalbum(), setAlbumImage(), and window.

Referenced by dropEvent(), and setAlbumImage().

setAlbumImage [2/2]

void TitleWidget::setAlbumImage ( Photo * photo )

slot

Sets the album image to the passed in photo.

Definition at line 510 of file titleWidget.cpp.

{
  if(selectedPhoto == NULL)
    return;
  //---------------------------------------------------------
  //set album image
  qApp->setOverrideCursor( QCursor(Qt::WaitCursor));
  albm->setRepresentativeImages( selectedPhoto->getImageFilename() );
  //---------------------------------------------------------
  //update onscreen image
  albumImage->setPixmap( *albm->getRepresentativeImage(SMALL) );
  qApp->restoreOverrideCursor();
  //---------------------------------------------------------
}

References albm, albumImage, Photo::getImageFilename(), Album::getRepresentativeImage(), ALabel::setPixmap(), Album::setRepresentativeImages(), and SMALL.

setBusy()

void TitleWidget::setBusy

(

bool

val

)

set program busy state

Definition at line 1257 of file titleWidget.cpp.

{
  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);
  }
  else
  {
    file->setItemEnabled(NEW_ALBUM, true);
    file->setItemEnabled(OPEN_ALBUM, true);
    file->setItemEnabled(SAVE_ALBUM, true);
    file->setItemEnabled(SAVEAS_ALBUM, true);
  }
}

References busy, file, NEW_ALBUM, OPEN_ALBUM, SAVE_ALBUM, and SAVEAS_ALBUM.

Referenced by SubalbumWidget::addImageAction(), exportLargeImages(), exportSmallWebGallery(), loadAlbum(), SubalbumWidget::removeImageAction(), SubalbumWidget::rotate270ImageAction(), SubalbumWidget::rotate90ImageAction(), saveAlbum(), and saveAsAlbum().

setSubalbumImage [1/2]

void TitleWidget::setSubalbumImage ( )

privateslot

Sets the Subalbum Image.

Definition at line 530 of file titleWidget.cpp.

{
  //---------------------------------------------------------
  //determine if a subalbum is even selected
  SubalbumWidget* sw = window->getLayout()->getSubalbum();
  if(sw == NULL)
    return;
  //---------------------------------------------------------
  //set collection image to selected photo
  setSubalbumImage( sw->getSelectedPhoto() );
}

References Window::getLayout(), SubalbumWidget::getSelectedPhoto(), LayoutWidget::getSubalbum(), setSubalbumImage(), and window.

Referenced by dropEvent(), and setSubalbumImage().

setSubalbumImage [2/2]

void TitleWidget::setSubalbumImage ( Photo * photo )

slot

Sets the subalbum image to the passed in photo.

Definition at line 542 of file titleWidget.cpp.

{
  if(selectedPhoto == NULL)
    return;
 
  //---------------------------------------------------------
  //set subalbum image
  qApp->setOverrideCursor( QCursor(Qt::WaitCursor));
  SubalbumWidget* sw = window->getLayout()->getSubalbum();
  sw->getSubalbum()->setRepresentativeImage( selectedPhoto->getThumbnailFilename() );  
  //---------------------------------------------------------
  //update onscreen image
  subalbumImage->setPixmap( *sw->getSubalbum()->getRepresentativeImage(SMALL) );
  SubalbumPreviewWidget* item = (SubalbumPreviewWidget*)window->getLayout()->getSubalbums()->getCurrentSelection();
  item->setPixmap( *sw->getSubalbum()->getRepresentativeImage(MEDIUM), false );
  qApp->restoreOverrideCursor();
  //---------------------------------------------------------
}

References SubalbumsWidget::getCurrentSelection(), Window::getLayout(), Subalbum::getRepresentativeImage(), LayoutWidget::getSubalbum(), SubalbumWidget::getSubalbum(), LayoutWidget::getSubalbums(), Photo::getThumbnailFilename(), MEDIUM, ALabel::setPixmap(), Subalbum::setRepresentativeImage(), SMALL, subalbumImage, and window.

settings

void TitleWidget::settings ( )

privateslot

Pops up settings window.

Definition at line 1180 of file titleWidget.cpp.

{
  //create window and center if not already present
  if(settingsWindow == NULL)
  {
    settingsWindow = new ConfigurationWidget( window->getConfig() );
    connect( settingsWindow, SIGNAL(closed()),
                  this, SLOT(settingsWindowClosed()));
    settingsWindow->show();
    centerWindow(settingsWindow);
  }
 
  settingsWindow->raise();
  settingsWindow->setActiveWindow();
}

References centerWindow(), Window::getConfig(), settingsWindow, settingsWindowClosed(), and window.

Referenced by TitleWidget().

settingsWindowClosed

void TitleWidget::settingsWindowClosed ( )

slot

Definition at line 1246 of file titleWidget.cpp.

{
  delete settingsWindow;
  settingsWindow = NULL;
}

References settingsWindow.

Referenced by settings().

storeAnnotations

void TitleWidget::storeAnnotations ( )

privateslot

Store annotations.

Definition at line 404 of file titleWidget.cpp.

{
  //only sync backend album/collection data when detectModifications is enabled
  if( !detectModifications ) return;
 
  //set album annotations
  albm->setName        ( albumNameVal->text()        );
  albm->setDescription ( albumDescriptionVal->text() );
  albm->setAuthor      ( albumAuthorVal->text()      );
 
  //get subalbum pointer
  Subalbum* collection = window->getLayout()->getSubalbums()->getSelectedSubalbum();
  if(collection != NULL )
  {
    //store old subalbum name
    QString oldName =  collection->getName();
 
    //set name and description
    collection->setName(  subalbumNameVal->text()   );
    collection->setDescription(  subalbumDescriptionVal->text()   );
 
    //if subalbum name has changed emit signal
    if(oldName.compare( collection->getName() ) != 0)
      emit subalbumNameChanged();
  }
}

References albm, albumAuthorVal, albumDescriptionVal, albumNameVal, detectModifications, Window::getLayout(), Subalbum::getName(), SubalbumsWidget::getSelectedSubalbum(), LayoutWidget::getSubalbums(), Album::setAuthor(), Album::setDescription(), Subalbum::setDescription(), Album::setName(), Subalbum::setName(), subalbumDescriptionVal, subalbumNameChanged(), subalbumNameVal, and window.

Referenced by TitleWidget().

subalbumNameChanged

void TitleWidget::subalbumNameChanged ( )

signal

Emitted when user changes subalbum name.

Referenced by storeAnnotations().

unsetAlbumImage

void TitleWidget::unsetAlbumImage ( )

privateslot

Unsets the Album Image.

Definition at line 525 of file titleWidget.cpp.

{
  albm->setRepresentativeImages( QString::null );
}

References albm, and Album::setRepresentativeImages().

Referenced by TitleWidget().

unsetSubalbumImage

void TitleWidget::unsetSubalbumImage ( )

privateslot

Unsets the Subalbum Image.

Definition at line 561 of file titleWidget.cpp.

{
  SubalbumPreviewWidget* item = (SubalbumPreviewWidget*)window->getLayout()->getSubalbums()->getCurrentSelection();
  if(item != NULL && ((SubalbumPreviewWidget*)item)->getSubalbum() != NULL)
  {
    Subalbum* subalbm =  ((SubalbumPreviewWidget*)item)->getSubalbum();
    subalbm->setRepresentativeImage( QString::null );
    item->setPixmap( *subalbm->getRepresentativeImage(MEDIUM), false );
  }
}

References SubalbumsWidget::getCurrentSelection(), Window::getLayout(), Subalbum::getRepresentativeImage(), LayoutWidget::getSubalbums(), MEDIUM, Subalbum::setRepresentativeImage(), and window.

Referenced by TitleWidget().

updateAlbumAnnotations

void TitleWidget::updateAlbumAnnotations ( )

slot

Updates subalbum annotations.

Definition at line 431 of file titleWidget.cpp.

{
  //disable modification detection while updating fields
  detectModifications = false;
 
  //set album annotations
 
  //if no image then remove pixmap
  if( albm->getRepresentativeImage(LARGE) != NULL)
    albumImage->setPixmap( *albm->getRepresentativeImage(SMALL) );
  else
    albumImage->removePixmap();
 
  albumNameVal->setText( albm->getName() );
  albumNameVal->setCursorPosition(0);
  albumDescriptionVal->setText( albm->getDescription() );
  albumDescriptionVal->setCursorPosition(0);
  albumAuthorVal->setText( albm->getAuthor() );
  albumAuthorVal->setCursorPosition(0);
 
  //enable modification detection
  detectModifications = true;
}

References albm, albumAuthorVal, albumDescriptionVal, albumImage, albumNameVal, detectModifications, Album::getAuthor(), Album::getDescription(), Album::getName(), Album::getRepresentativeImage(), LARGE, ALabel::removePixmap(), ALabel::setPixmap(), and SMALL.

Referenced by refresh().

updateMenus

void TitleWidget::updateMenus ( bool anySelected = false, bool anyRevertable = false )

slot

update begin presentation menu entry - disabled when no photos in album

Definition at line 1551 of file titleWidget.cpp.

{
  //no photos? disable begin presentation command
//  tools->setItemEnabled( BEGIN_PRESENTATION, albm->getNumPhotos() != 0 );
//  tools->setItemEnabled( BEGIN_PRESENTATION_AT, albm->getNumPhotos() != 0 );  
 
  //none selected? disable removing photo descriptions
  photoMenu->setItemEnabled( REMOVE_DESCRIPTIONS, anySelected );
 
  //none revertable? disable revert photos
  photoMenu->setItemEnabled( REVERT_PHOTOS, anyRevertable );
}

References photoMenu, REMOVE_DESCRIPTIONS, and REVERT_PHOTOS.

Referenced by SubalbumWidget::addImageAction(), SubalbumsWidget::deleteAction(), loadAlbum(), and LayoutWidget::photoStateChangedEvent().

useAnimation()

void TitleWidget::useAnimation

(

bool

val

)

Use animation for rep images?

Definition at line 379 of file titleWidget.cpp.

{
  //enable animation
  if(val)
  {
    albumImage->setAnimationMethods( SLIDE_IN_LEFT, SLIDE_OUT_LEFT,
                                                                FADE_TRANSITION, FADE_TRANSITION);
    subalbumImage->setAnimationMethods( SLIDE_IN_LEFT, SLIDE_OUT_LEFT,
                                                                FADE_TRANSITION, FADE_TRANSITION);
  }
  //disable animation
  else
  {
    albumImage->setAnimationMethods();
    subalbumImage->setAnimationMethods();
  }
}

References albumImage, FADE_TRANSITION, ALabel::setAnimationMethods(), SLIDE_IN_LEFT, SLIDE_OUT_LEFT, and subalbumImage.

Referenced by Window::Window().

windowStateChanged

void TitleWidget::windowStateChanged ( bool state )

slot

Enables/disables "minimize" window menu entry depending on window state.

Definition at line 1359 of file titleWidget.cpp.

{ 
//Do nothing 
}

Referenced by Window::event(), Window::hideEvent(), and Window::showEvent().

Member Data Documentation

about

About* TitleWidget::about

private

About dialog pointer.

Definition at line 277 of file titleWidget.h.

Referenced by aboutClosed(), aboutProgram(), and TitleWidget().

albm

Album* TitleWidget::albm

private

Backend album object.

Definition at line 265 of file titleWidget.h.

Referenced by albumStatistics(), getAlbum(), loadAlbum(), newAlbum(), proceedWithLoad(), revertToSaved(), saveAlbum(), saveAsAlbum(), setAlbum(), setAlbumImage(), storeAnnotations(), TitleWidget(), unsetAlbumImage(), updateAlbumAnnotations(), and ~TitleWidget().

albumAnnotationFrame

Q3Frame* TitleWidget::albumAnnotationFrame

private

Definition at line 246 of file titleWidget.h.

Referenced by TitleWidget().

albumAnnotationGrid

Q3GridLayout* TitleWidget::albumAnnotationGrid

private

Album annotation grid.

Definition at line 245 of file titleWidget.h.

Referenced by TitleWidget().

albumAuthor

QLabel* TitleWidget::albumAuthor

private

Definition at line 252 of file titleWidget.h.

Referenced by TitleWidget().

albumAuthorVal

QLineEdit* TitleWidget::albumAuthorVal

private

Definition at line 253 of file titleWidget.h.

Referenced by saveAsAlbum(), storeAnnotations(), TitleWidget(), and updateAlbumAnnotations().

albumDescription

QLabel* TitleWidget::albumDescription

private

Definition at line 250 of file titleWidget.h.

Referenced by TitleWidget().

albumDescriptionVal

QLineEdit* TitleWidget::albumDescriptionVal

private

Definition at line 251 of file titleWidget.h.

Referenced by storeAnnotations(), TitleWidget(), and updateAlbumAnnotations().

albumImage

ALabel* TitleWidget::albumImage

private

Definition at line 247 of file titleWidget.h.

Referenced by newAlbum(), setAlbumImage(), TitleWidget(), updateAlbumAnnotations(), and useAnimation().

albumName

QLabel* TitleWidget::albumName

private

Definition at line 248 of file titleWidget.h.

Referenced by TitleWidget().

albumNameVal

QLineEdit* TitleWidget::albumNameVal

private

Definition at line 249 of file titleWidget.h.

Referenced by storeAnnotations(), TitleWidget(), and updateAlbumAnnotations().

albumStats

AlbumStatistics* TitleWidget::albumStats

private

Album Statistics dialog pointer.

Definition at line 271 of file titleWidget.h.

Referenced by albumStatistics(), albumStatisticsClosed(), and TitleWidget().

BEGIN_PRESENTATION

int TitleWidget::BEGIN_PRESENTATION

private

tools menu item id's

Definition at line 302 of file titleWidget.h.

BEGIN_PRESENTATION_AT

int TitleWidget::BEGIN_PRESENTATION_AT

private

Definition at line 303 of file titleWidget.h.

busy

bool TitleWidget::busy

private

Is the program currently busy? helps block other operations.

Definition at line 283 of file titleWidget.h.

Referenced by getBusy(), setBusy(), and TitleWidget().

cacheSetButtonState

bool TitleWidget::cacheSetButtonState

private

cached set button state

Definition at line 306 of file titleWidget.h.

customRecentMenuItems

RecentAlbumMenuItem** TitleWidget::customRecentMenuItems

private

Definition at line 221 of file titleWidget.h.

Referenced by populateOpenRecentMenu(), and refreshOpenRecentMenu().

detectModifications

bool TitleWidget::detectModifications

private

Definition at line 286 of file titleWidget.h.

Referenced by refreshCollectionAnnotations(), storeAnnotations(), TitleWidget(), and updateAlbumAnnotations().

EXPORT_LARGE_IMAGES

int TitleWidget::EXPORT_LARGE_IMAGES

private

Definition at line 295 of file titleWidget.h.

Referenced by TitleWidget().

EXPORT_SMALL_WEB_GALLERY

int TitleWidget::EXPORT_SMALL_WEB_GALLERY

private

Definition at line 294 of file titleWidget.h.

Referenced by TitleWidget().

file

Q3PopupMenu* TitleWidget::file

private

File menu.

Definition at line 215 of file titleWidget.h.

Referenced by loadAlbum(), newAlbum(), saveAlbum(), saveAsAlbum(), setBusy(), and TitleWidget().

helpMenu

Q3PopupMenu* TitleWidget::helpMenu

private

Window menu, only used in OSX.

Help menu

Definition at line 238 of file titleWidget.h.

Referenced by TitleWidget().

helpWindow

HelpWindow* TitleWidget::helpWindow

private

HelpWindow pointer.

Definition at line 280 of file titleWidget.h.

Referenced by help(), helpClosed(), and TitleWidget().

mainFrame

Q3Frame* TitleWidget::mainFrame

private

Definition at line 242 of file titleWidget.h.

Referenced by TitleWidget().

mainGrid

Q3GridLayout* TitleWidget::mainGrid

private

Main grid.

Definition at line 241 of file titleWidget.h.

Referenced by TitleWidget().

menu

QMenuBar* TitleWidget::menu

private

Menubar file menu and help menu inserted in.

Definition at line 212 of file titleWidget.h.

Referenced by TitleWidget().

NEW_ALBUM

int TitleWidget::NEW_ALBUM

private

Definition at line 289 of file titleWidget.h.

Referenced by setBusy(), and TitleWidget().

numRecentMenuItems

int TitleWidget::numRecentMenuItems

private

Definition at line 220 of file titleWidget.h.

Referenced by populateOpenRecentMenu(), and refreshOpenRecentMenu().

OPEN_ALBUM

int TitleWidget::OPEN_ALBUM

private

Definition at line 290 of file titleWidget.h.

Referenced by setBusy(), and TitleWidget().

openRecent

Q3PopupMenu* TitleWidget::openRecent

private

Open recent submenu.

Definition at line 218 of file titleWidget.h.

Referenced by populateOpenRecentMenu(), refreshOpenRecentMenu(), and TitleWidget().

photoMenu

Q3PopupMenu* TitleWidget::photoMenu

private

Photos menu.

Definition at line 225 of file titleWidget.h.

Referenced by TitleWidget(), and updateMenus().

recentAlbums

RecentAlbums TitleWidget::recentAlbums

private

Definition at line 312 of file titleWidget.h.

Referenced by clearOpenRecentMenu(), getRecentAlbums(), loadAlbum(), loadRecentAlbum(), populateOpenRecentMenu(), refreshOpenRecentMenu(), saveAlbum(), saveAsAlbum(), and TitleWidget().

recentMenuItems

int* TitleWidget::recentMenuItems

private

Definition at line 219 of file titleWidget.h.

Referenced by populateOpenRecentMenu(), and refreshOpenRecentMenu().

REMOVE_DESCRIPTIONS

int TitleWidget::REMOVE_DESCRIPTIONS

private

photos menu item id's

Definition at line 298 of file titleWidget.h.

Referenced by TitleWidget(), and updateMenus().

REVERT_PHOTOS

int TitleWidget::REVERT_PHOTOS

private

Definition at line 299 of file titleWidget.h.

Referenced by TitleWidget(), and updateMenus().

REVERT_TO_SAVED_ALBUM

int TitleWidget::REVERT_TO_SAVED_ALBUM

private

Definition at line 293 of file titleWidget.h.

Referenced by loadAlbum(), newAlbum(), saveAlbum(), saveAsAlbum(), and TitleWidget().

SAVE_ALBUM

int TitleWidget::SAVE_ALBUM

private

Definition at line 291 of file titleWidget.h.

Referenced by setBusy(), and TitleWidget().

SAVEAS_ALBUM

int TitleWidget::SAVEAS_ALBUM

private

Definition at line 292 of file titleWidget.h.

Referenced by setBusy(), and TitleWidget().

settingsWindow

ConfigurationWidget* TitleWidget::settingsWindow

private

Settings dialog pointer.

Definition at line 274 of file titleWidget.h.

Referenced by settings(), settingsWindowClosed(), and TitleWidget().

subalbumAnnotationFrame

Q3Frame* TitleWidget::subalbumAnnotationFrame

private

Definition at line 257 of file titleWidget.h.

Referenced by loadAlbum(), refreshCollectionAnnotations(), and TitleWidget().

subalbumAnnotationGrid

Q3GridLayout* TitleWidget::subalbumAnnotationGrid

private

Subalbum annotation grid.

Definition at line 256 of file titleWidget.h.

Referenced by TitleWidget().

subalbumDescription

QLabel* TitleWidget::subalbumDescription

private

Definition at line 261 of file titleWidget.h.

Referenced by TitleWidget().

subalbumDescriptionVal

QLineEdit* TitleWidget::subalbumDescriptionVal

private

Definition at line 262 of file titleWidget.h.

Referenced by refreshCollectionAnnotations(), storeAnnotations(), and TitleWidget().

subalbumImage

ALabel* TitleWidget::subalbumImage

private

Definition at line 258 of file titleWidget.h.

Referenced by loadAlbum(), newAlbum(), refreshCollectionAnnotations(), setSubalbumImage(), TitleWidget(), and useAnimation().

subalbumName

QLabel* TitleWidget::subalbumName

private

Definition at line 259 of file titleWidget.h.

Referenced by TitleWidget().

subalbumNameVal

QLineEdit* TitleWidget::subalbumNameVal

private

Definition at line 260 of file titleWidget.h.

Referenced by refreshCollectionAnnotations(), storeAnnotations(), and TitleWidget().

tmpDirErrorDesc

QString TitleWidget::tmpDirErrorDesc

private

Definition at line 309 of file titleWidget.h.

Referenced by loadAlbum(), newAlbum(), and TitleWidget().

tmpDirErrorMessage

QString TitleWidget::tmpDirErrorMessage

private

error message and description when temp directory cannot be created

Definition at line 309 of file titleWidget.h.

Referenced by loadAlbum(), newAlbum(), and TitleWidget().

tools

Q3PopupMenu* TitleWidget::tools

private

Tools menu.

Definition at line 228 of file titleWidget.h.

Referenced by TitleWidget().

window

Window* TitleWidget::window

private

Window pointer.

Definition at line 268 of file titleWidget.h.

Referenced by createTmpDir(), dropEvent(), exportLargeImages(), exportSmallWebGallery(), loadAlbum(), loadAlbum(), newAlbum(), proceedWithLoad(), quitApplication(), refresh(), removeSelectedPhotoDesc(), revertPhotos(), revertToSaved(), saveAlbum(), saveAsAlbum(), setAlbumImage(), setSubalbumImage(), setSubalbumImage(), settings(), storeAnnotations(), TitleWidget(), and unsetSubalbumImage().

---

The documentation for this class was generated from the following files:

• titleWidget.h
• titleWidget.cpp