Photo Class Reference

#include <photo.h>

Collaboration diagram for Photo:

[legend]List of all members.

---

Detailed Description

A photo consists of an image and a description.

Definition at line 41 of file photo.h.

Public Member Functions
	Photo (Subalbum *subalbum, int number)
	Sets default information.
	~Photo ()
	Destructor.
void	setImageFilename (QString val)
	Sets the image filename.
void	setSlideshowFilename (QString val)
	Sets the slideshow filename.
void	setThumbnailFilename (QString val)
	Sets the thumbnail filename.
QString	getImageFilename ()
	Gets the image filename.
QString	getSlideshowFilename ()
	Gets the slideshow filename.
QString	getThumbnailFilename ()
	Gets the thumbnail filename.
bool	setImage (const QString &imageName)
	Sets image, returns TRUE if successful, this method used when loading and image from file for the first time (aka when photo added to subalbum).
bool	setImage (const QString &imageName, const QString &slideshowName, const QString &thumbnailName)
	Sets the image, uses loads thumbnail and slideshow from file (no scaling), returns TRUE if successful.
bool	setImage (QImage *fullImage)
	Sets the image.
void	setDescription (QString val)
	Sets the description.
QString	getDescription ()
	Gets the description.
Photo *	getNext ()
	Gets pointer to next photo.
void	setNext (Photo *val)
	Sets pointer to next photo.
QImage *	getImage (int size)
	Gets image.
QDateTime *	importFromDisk (QDomNode *root)
	Builds photo from XML DOM node, returns date modified info from xml.
void	exportToXML (QTextStream &stream)
	Exports photo to xml.
void	exportThumbnailHTML (QTextStream &stream)
	Exports to thumbnail html format.
void	exportSlideshowHTML (QTextStream &stream)
	Exports to slideshow html format.
void	rotate90 ()
	Rotates image clockwise by 90 degrees.
void	rotate270 ()
	Rotates image clockwise by 270 degrees.
void	flipHorizontally ()
	Flips image about horizontal axis.
void	flipVertically ()
	Flips image about vertical axis.
void	setThumbnailChecksum (QString val)
	Update thumbnail checksum.
void	setSlideshowChecksum (QString val)
	Update slideshow checksum.
void	setImageChecksum (QString val)
	Update image checksum.
QString	getThumbnailChecksum ()
	Get thumbanil checksum.
QString	getSlideshowChecksum ()
	Get thumbanil checksum.
QString	getImageChecksum ()
	Get image checksum.
void	deallocateLargeImages ()
	Frees full image and slideshow versions to conserve memory.
void	setNeedsSavingVal (bool val)
	Sets if the image needs to be saved to its permanent location.
bool	getNeedsSavingVal ()
	Returns if the image needs to be saved to its permament location.
int	getInitialPhotoNumber ()
	Returns initial photo number.
int	getInitialSubalbumNumber ()
	Returns intiial subalbum number.
void	setInitialPhotoNumber (int val)
	Sets initial photo number.
void	setInitialSubalbumNumber (int val)
	Sets initial subalbum number.
int	actualSlideshowWidth ()
	Return actual slideshow image width (not including whitespace).
int	actualSlideshowHeight ()
	Return actual slideshow image height (not including whitespace).
void	setActualSlideshowDimensions (int w, int h)
	Sets actual slideshow image size.
Private Attributes
Subalbum *	subalbum
	Subalbum photo is in.
int	initialNumber
int	initialSubalbumNumber
Photo *	next
	Pointer to next photo.
QString	description
	Longer description of subalbum.
QImage *	thumbnailImage
	Thumbnail used for saving to disk.
QImage *	paddedThumbnailImage
	A padded thumbnail used for subalbum layout.
QImage *	slideshowImage
	Slideshow iamge.
QImage *	fullImage
	Actual image.
QString	imageChecksum
	MD5 checksums, ued to determine if image/thumbnail have been changed.
QString	slideshowChecksum
QString	thumbnailChecksum
QString	imageLocation
	Image filename.
QString	slideshowLocation
	Slideshow filename.
QString	thumbnailLocation
	Thumbnail filename.
bool	needsSaving
	Does the image need to be saved to the permanent location?
int	slideshowWidth
	Unpadded width of slideshow image.
int	slideshowHeight
	Unpadded height of slideshow image.

---

Constructor & Destructor Documentation

Photo::Photo (  Subalbum *  subalbum, int  number )

Sets default information. Definition at line 36 of file photo.cpp. References description, fullImage, imageChecksum, imageLocation, initialNumber, initialSubalbumNumber, needsSaving, next, paddedThumbnailImage, slideshowChecksum, slideshowHeight, slideshowImage, slideshowLocation, slideshowWidth, thumbnailChecksum, thumbnailImage, and thumbnailLocation. { //set subalbum pointer this->subalbum = subalbum; //set initial photo number and subalbum number initialNumber = number; initialSubalbumNumber = subalbum->getSubalbumNumber(); //set strings to default values description = QString::null;; //set next pointer to NULL next = NULL; //set thumbnail image thumbnailImage = NULL; paddedThumbnailImage = NULL; slideshowImage = NULL; fullImage = NULL; //set checksums to the empty string by default imageChecksum = QString::null; slideshowChecksum = QString::null; thumbnailChecksum = QString::null; //image does not need to be saved by default needsSaving = false; //filenames not set by default imageLocation = QString::null; slideshowLocation = QString::null; thumbnailLocation = QString::null; //no dimension of slideshow image known yet slideshowWidth = -1; slideshowHeight = -1; }

Photo::~Photo (   )

Destructor. Definition at line 76 of file photo.cpp. References fullImage, paddedThumbnailImage, slideshowImage, and thumbnailImage. { if(paddedThumbnailImage != thumbnailImage) delete paddedThumbnailImage; delete thumbnailImage; delete slideshowImage; delete fullImage; }

---

Member Function Documentation

int Photo::actualSlideshowHeight (   )

Return actual slideshow image height (not including whitespace). Definition at line 844 of file photo.cpp. References slideshowHeight. Referenced by PhotoEditWidget::adjustExposure(), PhotoViewWidget::cropSelectedPoint(), PhotoEditWidget::findActualSelection(), PhotoViewWidget::getSelection(), PhotoEditWidget::grayscaleSelection(), PhotoEditWidget::invertSelection(), and PhotoViewWidget::selectAll(). { return slideshowHeight; }

int Photo::actualSlideshowWidth (   )

Return actual slideshow image width (not including whitespace). Definition at line 839 of file photo.cpp. References slideshowWidth. Referenced by PhotoEditWidget::adjustExposure(), PhotoViewWidget::cropSelectedPoint(), PhotoEditWidget::findActualSelection(), PhotoViewWidget::getSelection(), PhotoEditWidget::grayscaleSelection(), PhotoEditWidget::invertSelection(), and PhotoViewWidget::selectAll(). { return slideshowWidth;; }

void Photo::deallocateLargeImages (   )

Frees full image and slideshow versions to conserve memory. Definition at line 770 of file photo.cpp. References fullImage, and slideshowImage. Referenced by Subalbum::addPhoto(), flipHorizontally(), flipVertically(), rotate270(), rotate90(), and setImage(). { delete fullImage; fullImage = NULL; delete slideshowImage; slideshowImage = NULL; }

void Photo::exportSlideshowHTML (  QTextStream &  stream  )

Exports to slideshow html format. Definition at line 378 of file photo.cpp. { //write photo information stream << "?"; }

void Photo::exportThumbnailHTML (  QTextStream &  stream  )

Exports to thumbnail html format. Definition at line 372 of file photo.cpp. { //write photo information stream << "?"; }

void Photo::exportToXML (  QTextStream &  stream  )

Exports photo to xml. Definition at line 314 of file photo.cpp. References description, fixXMLString(), getImageFilename(), getSlideshowFilename(), getThumbnailFilename(), imageChecksum, slideshowChecksum, and thumbnailChecksum. Referenced by Subalbum::exportToXML(). { QFileInfo info; //write photo information stream << " <photo>\n"; //----- stream << " <description>" << fixXMLString(description) << "</description>\n"; //----- //full image info.setFile( getImageFilename() ); QDateTime modified = info.lastModified(); stream << " <image>\n"; stream << " <md5>" << fixXMLString(imageChecksum) << "</md5>\n"; stream << " <modified>"; stream << modified.date().year() << " "; stream << modified.date().month() << " "; stream << modified.date().day() << " "; stream << modified.time().hour() << " "; stream << modified.time().minute() << " "; stream << modified.time().second() << " "; stream << modified.time().msec() << "</modified>\n"; stream << " </image>\n"; //----- //slidehow image info.setFile( getSlideshowFilename() ); modified = info.lastModified(); stream << " <slideshow>\n"; stream << " <md5>" << fixXMLString(slideshowChecksum) << "</md5>\n"; stream << " <modified>"; stream << modified.date().year() << " "; stream << modified.date().month() << " "; stream << modified.date().day() << " "; stream << modified.time().hour() << " "; stream << modified.time().minute() << " "; stream << modified.time().second() << " "; stream << modified.time().msec() << "</modified>\n"; stream << " </slideshow>\n"; //----- //thumbnail image info.setFile( getThumbnailFilename() ); modified = info.lastModified(); stream << " <thumb>\n"; stream << " <md5>" << fixXMLString(thumbnailChecksum) << "</md5>\n"; stream << " <modified>"; stream << modified.date().year() << " "; stream << modified.date().month() << " "; stream << modified.date().day() << " "; stream << modified.time().hour() << " "; stream << modified.time().minute() << " "; stream << modified.time().second() << " "; stream << modified.time().msec() << "</modified>\n"; stream << " </thumb>\n"; //----- stream << " </photo>\n"; }

void Photo::flipHorizontally (   )

Flips image about horizontal axis. Definition at line 670 of file photo.cpp. References createImages(), deallocateLargeImages(), imageLocation, initialNumber, initialSubalbumNumber, needsSaving, paddedThumbnailImage, Subalbum::setModified(), slideshowHeight, slideshowImage, slideshowLocation, slideshowWidth, subalbum, and thumbnailImage. { //load up image QImage origImage(imageLocation); QImage newImage = origImage.mirror(false,true); //create thumbnail createImages(&newImage, &slideshowImage, &thumbnailImage, &paddedThumbnailImage, slideshowWidth, slideshowHeight); //save out updated full and slideshow images to temp folder and deallocate memory imageLocation = QDir::homeDirPath() + QString("/.albumShaper/tmp/%1_%2.jpg") .arg(initialSubalbumNumber) .arg(initialNumber); slideshowLocation = QDir::homeDirPath() + QString("/.albumShaper/tmp/%1_%2_slideshow.jpg") .arg(initialSubalbumNumber) .arg(initialNumber); newImage.save( imageLocation, "JPEG", 100); slideshowImage->save( slideshowLocation, "JPEG", 100); //mark image as having been modified and hence in the tmp folder needsSaving = true; //deallocate qimage objects deallocateLargeImages(); //set the subalbum as being modified subalbum->setModified(); }

void Photo::flipVertically (   )

Flips image about vertical axis. Definition at line 705 of file photo.cpp. References createImages(), deallocateLargeImages(), imageLocation, initialNumber, initialSubalbumNumber, needsSaving, paddedThumbnailImage, Subalbum::setModified(), slideshowHeight, slideshowImage, slideshowLocation, slideshowWidth, subalbum, and thumbnailImage. { //load up image QImage origImage(imageLocation); QImage newImage = origImage.mirror(true,false); //create thumbnail createImages(&newImage, &slideshowImage, &thumbnailImage, &paddedThumbnailImage, slideshowWidth, slideshowHeight); //save out updated full and slideshow images to temp folder and deallocate memory imageLocation = QDir::homeDirPath() + QString("/.albumShaper/tmp/%1_%2.jpg") .arg(initialSubalbumNumber) .arg(initialNumber); slideshowLocation = QDir::homeDirPath() + QString("/.albumShaper/tmp/%1_%2_slideshow.jpg") .arg(initialSubalbumNumber) .arg(initialNumber); newImage.save( imageLocation, "JPEG", 100); slideshowImage->save( slideshowLocation, "JPEG", 100); //mark image as having been modified and hence in the tmp folder needsSaving = true; //deallocate qimage objects deallocateLargeImages(); //set the subalbum as being modified subalbum->setModified(); }

QString Photo::getDescription (   )

Gets the description. Definition at line 246 of file photo.cpp. References description. Referenced by PhotoWidget::updateDescription(). { return QString(description); }

QImage * Photo::getImage (  int  size  )

Gets image. Definition at line 266 of file photo.cpp. References fullImage, IMAGE, imageLocation, initialNumber, initialSubalbumNumber, needsSaving, PADDED_THUMBNAIL, paddedThumbnailImage, SLIDESHOW, slideshowImage, slideshowLocation, THUMBNAIL, and thumbnailImage. Referenced by Subalbum::addPhoto(), Album::exportSubalbumImages(), TitleWidget::setImageAction(), SubalbumWidget::setImageAction(), and PhotoWidget::updateImage(). { if(size == THUMBNAIL) return thumbnailImage; else if(size == PADDED_THUMBNAIL) return paddedThumbnailImage; else if(size == SLIDESHOW) { if( slideshowImage != NULL) return slideshowImage; else { if(!needsSaving) { return new QImage(slideshowLocation); } else { QString tmpImageLocation = QDir::homeDirPath() + QString("/.albumShaper/tmp/%1_%2_slideshow.jpg") .arg(initialSubalbumNumber) .arg(initialNumber); return new QImage(tmpImageLocation); } } } else if(size == IMAGE) { if( fullImage != NULL) return fullImage; else { if(!needsSaving) { return new QImage(imageLocation); } else { QString tmpImageLocation = QDir::homeDirPath() + QString("/.albumShaper/tmp/%1_%2.jpg") .arg(initialSubalbumNumber) .arg(initialNumber); return new QImage(tmpImageLocation); } } } else return NULL; }

QString Photo::getImageChecksum (   )

Get image checksum. Definition at line 765 of file photo.cpp. References imageChecksum. Referenced by Subalbum::importFromDisk(). { return imageChecksum; }

QString Photo::getImageFilename (   )

Gets the image filename. Definition at line 794 of file photo.cpp. References imageLocation. Referenced by PhotoEditWidget::adjustExposure(), AlbumStatistics::AlbumStatistics(), PhotoEditWidget::cropToRegion(), Album::exportSubalbumImages(), exportToXML(), PhotoEditWidget::grayscaleSelection(), and PhotoEditWidget::invertSelection(). { return imageLocation; }

int Photo::getInitialPhotoNumber (   )

Returns initial photo number. Definition at line 819 of file photo.cpp. References initialNumber. Referenced by Album::exportSubalbumImages(), and Album::reorderSubalbumImages(). { return initialNumber; }

int Photo::getInitialSubalbumNumber (   )

Returns intiial subalbum number. Definition at line 824 of file photo.cpp. References initialSubalbumNumber. Referenced by Album::exportSubalbumImages(), and Album::reorderSubalbumImages(). { return initialSubalbumNumber; }

bool Photo::getNeedsSavingVal (   )

Returns if the image needs to be saved to its permament location. Definition at line 814 of file photo.cpp. References needsSaving. Referenced by Album::exportSubalbumImages(). { return needsSaving; }

Photo * Photo::getNext (   )

Gets pointer to next photo. Definition at line 252 of file photo.cpp. References next. Referenced by AlbumStatistics::AlbumStatistics(), Album::exportSubalbumImages(), Subalbum::exportToXML(), Subalbum::photoMoved(), SubalbumWidget::refreshPhotos(), Subalbum::removePhoto(), Album::reorderSubalbumImages(), and Subalbum::~Subalbum(). { return next; }

QString Photo::getSlideshowChecksum (   )

Get thumbanil checksum. Definition at line 760 of file photo.cpp. References slideshowChecksum. Referenced by Subalbum::importFromDisk(). { return slideshowChecksum; }

QString Photo::getSlideshowFilename (   )

Gets the slideshow filename. Definition at line 799 of file photo.cpp. References slideshowLocation. Referenced by AlbumStatistics::AlbumStatistics(), Album::exportSubalbumImages(), exportToXML(), and PhotoViewWidget::setPhoto(). { return slideshowLocation; }

QString Photo::getThumbnailChecksum (   )

Get thumbanil checksum. Definition at line 755 of file photo.cpp. References thumbnailChecksum. Referenced by Subalbum::importFromDisk(). { return thumbnailChecksum; }

QString Photo::getThumbnailFilename (   )

Gets the thumbnail filename. Definition at line 804 of file photo.cpp. References thumbnailLocation. Referenced by exportToXML(). { return thumbnailLocation; }

QDateTime * Photo::importFromDisk (  QDomNode *  root  )

Builds photo from XML DOM node, returns date modified info from xml. Definition at line 384 of file photo.cpp. References description, imageChecksum, slideshowChecksum, and thumbnailChecksum. Referenced by Subalbum::importFromDisk(). { //create modified date/time object for returning QDateTime* modified = new QDateTime[3]; QDomNode node = root->firstChild(); QDomText val; while( !node.isNull() ) { //------------------------------------------------------------ //photo description if( node.isElement() && node.nodeName() == "description" ) { val = node.firstChild().toText(); if(!val.isNull()) description = val.nodeValue(); } //------------------------------------------------------------ //image information else if( node.isElement() && node.nodeName() == "image" ) { QDomNode childNode = node.firstChild(); while( !childNode.isNull() ) { //------------------------------------------------------------ if( childNode.isElement() && childNode.nodeName() == "md5" ) { val = childNode.firstChild().toText(); if(!val.isNull()) imageChecksum = val.nodeValue(); } //------------------------------------------------------------ else if( childNode.isElement() && childNode.nodeName() == "modified" ) { val = childNode.firstChild().toText(); //split value based on spaces, should be 7 fields QStringList vals = QStringList::split( QRegExp(" "), val.nodeValue() ); int i=0; int intVals[7]; QStringList::Iterator it; for ( it = vals.begin(); it != vals.end(); ++it ) { //sanity check incase more fields are provided than there should be if(i >6) break; intVals[i] = QString(*it).toInt(); i++; } modified[0].setDate( QDate(intVals[0], intVals[1], intVals[2]) ); modified[0].setTime( QTime(intVals[3], intVals[4], intVals[5], intVals[6]) ); } //------------------------------------------------------------ childNode = childNode.nextSibling(); } } //------------------------------------------------------------ //slideshow information else if( node.isElement() && node.nodeName() == "slideshow" ) { QDomNode childNode = node.firstChild(); while( !childNode.isNull() ) { //------------------------------------------------------------ if( childNode.isElement() && childNode.nodeName() == "md5" ) { val = childNode.firstChild().toText(); if(!val.isNull()) slideshowChecksum = val.nodeValue(); } //------------------------------------------------------------ else if( childNode.isElement() && childNode.nodeName() == "modified" ) { val = childNode.firstChild().toText(); //split value based on spaces, should be 6 fields QStringList vals = QStringList::split( QRegExp(" "), val.nodeValue() ); int i=0; int intVals[7]; QStringList::Iterator it; for ( it = vals.begin(); it != vals.end(); ++it ) { //sanity check incase more fields are provided than there should be if(i >6) break; intVals[i] = QString(*it).toInt(); i++; } modified[1].setDate( QDate(intVals[0], intVals[1], intVals[2]) ); modified[1].setTime( QTime(intVals[3], intVals[4], intVals[5], intVals[6]) ); } //------------------------------------------------------------ childNode = childNode.nextSibling(); } } //------------------------------------------------------------ //slideshow information else if( node.isElement() && node.nodeName() == "thumb" ) { QDomNode childNode = node.firstChild(); while( !childNode.isNull() ) { //------------------------------------------------------------ if( childNode.isElement() && childNode.nodeName() == "md5" ) { val = childNode.firstChild().toText(); if(!val.isNull()) thumbnailChecksum = val.nodeValue(); } //------------------------------------------------------------ else if( childNode.isElement() && childNode.nodeName() == "modified" ) { val = childNode.firstChild().toText(); //split value based on spaces, should be 6 fields QStringList vals = QStringList::split( QRegExp(" "), val.nodeValue() ); int i=0; int intVals[7]; QStringList::Iterator it; for ( it = vals.begin(); it != vals.end(); ++it ) { //sanity check incase more fields are provided than there should be if(i >6) break; intVals[i] = QString(*it).toInt(); i++; } modified[2].setDate( QDate(intVals[0], intVals[1], intVals[2]) ); modified[2].setTime( QTime(intVals[3], intVals[4], intVals[5], intVals[6]) ); } //------------------------------------------------------------ childNode = childNode.nextSibling(); } } //------------------------------------------------------------ //------------------------------------------------------------ //Handle md5 info as specified in 1.0a and 1.0a2 xml format //image md5 else if( node.isElement() && node.nodeName() == "imageMD5" ) { val = node.firstChild().toText(); if(!val.isNull()) imageChecksum = val.nodeValue(); } //------------------------------------------------------------ //slideshow md5 else if( node.isElement() && node.nodeName() == "slideMD5" ) { val = node.firstChild().toText(); if(!val.isNull()) slideshowChecksum = val.nodeValue(); } //------------------------------------------------------------ //thumbnail md5 else if( node.isElement() && node.nodeName() == "thumbMD5" ) { val = node.firstChild().toText(); if(!val.isNull()) thumbnailChecksum = val.nodeValue(); } //------------------------------------------------------------ //------------------------------------------------------------ //advance to next node node = node.nextSibling(); //------------------------------------------------------------ } //return modification dates read in return modified; }

void Photo::rotate270 (   )

Rotates image clockwise by 270 degrees. Definition at line 615 of file photo.cpp. References createImages(), deallocateLargeImages(), fullImage, imageLocation, initialNumber, initialSubalbumNumber, needsSaving, paddedThumbnailImage, Subalbum::setModified(), slideshowHeight, slideshowImage, slideshowLocation, slideshowWidth, subalbum, and thumbnailImage. { //load up image //if not modified load from permanent location fullImage = new QImage(imageLocation); //create new image QImage* rotatedImage = new QImage(fullImage->height(), fullImage->width(), fullImage->depth()); rotatedImage->setAlphaBuffer(true); //copy data int x,y; for(x=0; x < fullImage->height(); x++) { for(y=0; y < fullImage->width(); y++) { rotatedImage->setPixel(x, fullImage->width() - 1 - y, fullImage->pixel(y, x) ); } } //delete old image and set new pointer delete fullImage; fullImage = rotatedImage; //create thumbnail createImages(fullImage, &slideshowImage, &thumbnailImage, &paddedThumbnailImage, slideshowWidth, slideshowHeight); //save out updated full and slideshow images to temp folder and deallocate memory imageLocation = QDir::homeDirPath() + QString("/.albumShaper/tmp/%1_%2.jpg") .arg(initialSubalbumNumber) .arg(initialNumber); slideshowLocation = QDir::homeDirPath() + QString("/.albumShaper/tmp/%1_%2_slideshow.jpg") .arg(initialSubalbumNumber) .arg(initialNumber); fullImage->save( imageLocation, "JPEG", 100); slideshowImage->save( slideshowLocation, "JPEG", 100); //mark image as having been modified and hence in the tmp folder needsSaving = true; //deallocate qimage objects deallocateLargeImages(); //set the subalbum as being modified subalbum->setModified(); }

void Photo::rotate90 (   )

Rotates image clockwise by 90 degrees. Definition at line 560 of file photo.cpp. References createImages(), deallocateLargeImages(), fullImage, imageLocation, initialNumber, initialSubalbumNumber, needsSaving, paddedThumbnailImage, Subalbum::setModified(), slideshowHeight, slideshowImage, slideshowLocation, slideshowWidth, subalbum, and thumbnailImage. { //load up image //if not modified load from permanent location fullImage = new QImage(imageLocation); //create new image QImage* rotatedImage = new QImage(fullImage->height(), fullImage->width(), fullImage->depth()); rotatedImage->setAlphaBuffer(true); //copy data int x,y; for(x=0; x < fullImage->height(); x++) { for(y=0; y < fullImage->width(); y++) { rotatedImage->setPixel(fullImage->height() - 1 - x, y, fullImage->pixel(y, x) ); } } //delete old image and set new pointer delete fullImage; fullImage = rotatedImage; //create thumbnail createImages(fullImage, &slideshowImage, &thumbnailImage, &paddedThumbnailImage, slideshowWidth, slideshowHeight); //save out updated full and slideshow images to temp folder and deallocate memory imageLocation = QDir::homeDirPath() + QString("/.albumShaper/tmp/%1_%2.jpg") .arg(initialSubalbumNumber) .arg(initialNumber); slideshowLocation = QDir::homeDirPath() + QString("/.albumShaper/tmp/%1_%2_slideshow.jpg") .arg(initialSubalbumNumber) .arg(initialNumber); fullImage->save( imageLocation, "JPEG", 100); slideshowImage->save( slideshowLocation, "JPEG", 100); //mark image as having been modified and hence in the tmp folder needsSaving = true; //deallocate qimage objects deallocateLargeImages(); //set the subalbum as being modified subalbum->setModified(); }

void Photo::setActualSlideshowDimensions (  int  w, int  h )

Sets actual slideshow image size. Definition at line 849 of file photo.cpp. References slideshowHeight, and slideshowWidth. { slideshowWidth = w; slideshowHeight = h; }

void Photo::setDescription (  QString  val  )

Sets the description. Definition at line 236 of file photo.cpp. References description, Subalbum::setModified(), and subalbum. Referenced by Subalbum::addPhoto(), PhotoWidget::sync(), and PhotoEditWidget::updateDescription(). { if(description != val) { description = val; subalbum->setModified(); } }

bool Photo::setImage (  QImage *  fullImage  )

Sets the image. this method used when modifications have been preformed like cropping, etc. Recreates slideshow and thumnail forms, marks photo for saving Definition at line 195 of file photo.cpp. References createImages(), deallocateLargeImages(), fullImage, imageLocation, initialNumber, initialSubalbumNumber, needsSaving, paddedThumbnailImage, Subalbum::setModified(), slideshowHeight, slideshowImage, slideshowLocation, slideshowWidth, subalbum, thumbnailImage, and thumbnailLocation. { //reset image object delete fullImage; fullImage = newFullImage; if(fullImage->isNull()) return false; //create slideshow and thumbnail formats createImages(fullImage, &slideshowImage, &thumbnailImage, &paddedThumbnailImage, slideshowWidth, slideshowHeight); //save out updated full and slideshow images to temp folder and deallocate memory imageLocation = QDir::homeDirPath() + QString("/.albumShaper/tmp/%1_%2.jpg") .arg(initialSubalbumNumber) .arg(initialNumber); slideshowLocation = QDir::homeDirPath() + QString("/.albumShaper/tmp/%1_%2_slideshow.jpg") .arg(initialSubalbumNumber) .arg(initialNumber); thumbnailLocation = QDir::homeDirPath() + QString("/.albumShaper/tmp/%1_%2_thumb.jpg") .arg(initialSubalbumNumber) .arg(initialNumber); fullImage->save( imageLocation, "JPEG", 100); slideshowImage->save( slideshowLocation, "JPEG", 100); //mark image as having been modified and hence in the tmp folder needsSaving = true; //set the subalbum as being modified subalbum->setModified(); //deallocate qimage objects deallocateLargeImages(); return true; }

bool Photo::setImage (  const QString &  imageName, const QString &  slideshowName, const QString &  thumbnailName )

Sets the image, uses loads thumbnail and slideshow from file (no scaling), returns TRUE if successful. THis method used when loading from xml and no scaling should need to be done, we hope Definition at line 123 of file photo.cpp. References fullImage, imageLocation, needsSaving, paddedThumbnailImage, Subalbum::setModified(), slideshowImage, slideshowLocation, subalbum, THUMBNAIL_HEIGHT, THUMBNAIL_WIDTH, thumbnailImage, and thumbnailLocation. { //--------------------------------------------------------- //free old images delete fullImage; if(paddedThumbnailImage != thumbnailImage) delete paddedThumbnailImage; delete thumbnailImage; delete slideshowImage; fullImage = NULL; paddedThumbnailImage = NULL; thumbnailImage = NULL; slideshowImage = NULL; //--------------------------------------------------------- //construct thumbnail image thumbnailImage = new QImage(thumbnailName); if(thumbnailImage->isNull()) return false; //--------------------------------------------------------- //construct padded thumbnail image //if scaled thumbnail image is same size as padded thumbnail should be reuse object if(thumbnailImage->width() == THUMBNAIL_WIDTH && thumbnailImage->height() == THUMBNAIL_HEIGHT) { paddedThumbnailImage = thumbnailImage; } //else pad thumbnail else { //created padded thumbnail image paddedThumbnailImage = new QImage(THUMBNAIL_WIDTH, THUMBNAIL_HEIGHT, thumbnailImage->depth()); paddedThumbnailImage->setAlphaBuffer(true); //copy scaled image into centered portion of padded image int xDiff = THUMBNAIL_WIDTH - thumbnailImage->width(); int yDiff = THUMBNAIL_HEIGHT - thumbnailImage->height(); //set all pixels to white paddedThumbnailImage->fill(Qt::white.rgb()); int x,y; int x2 = 0; int y2; for(x = xDiff/2; x< (xDiff/2) + thumbnailImage->width(); x++) { y2 = 0; for(y = yDiff/2; y < (yDiff/2) + thumbnailImage->height(); y++) { paddedThumbnailImage->setPixel(x, y, thumbnailImage->pixel(x2, y2)); y2++; } x2++; } } //--------------------------------------------------------- //save new image filenames imageLocation = imageName; slideshowLocation = slideshowName; thumbnailLocation = thumbnailName; //--------------------------------------------------------- //image loaded from file, no need to save it again just yet needsSaving = false; //set the subalbum as being modified subalbum->setModified(); return true; //--------------------------------------------------------- }

bool Photo::setImage (  const QString &  imageName  )

Sets image, returns TRUE if successful, this method used when loading and image from file for the first time (aka when photo added to subalbum). Definition at line 85 of file photo.cpp. References createImages(), fullImage, imageLocation, needsSaving, paddedThumbnailImage, Subalbum::setModified(), slideshowHeight, slideshowImage, slideshowWidth, subalbum, and thumbnailImage. Referenced by Subalbum::addPhoto(), PhotoEditWidget::applyImageUpdate(), Subalbum::lazyAddPhoto(), and PhotoEditWidget::resetImageAction(). { //reset image object delete fullImage; //load up image, converting it's depth... QImage tempImage = QImage(filename).convertDepth(32); fullImage = new QImage(tempImage.width(), tempImage.height(), 32); if(fullImage->isNull()) return false; int x, y; for(x = 0; x<tempImage.width(); x++) { for(y = 0; y<tempImage.height(); y++) { fullImage->setPixel(x, y, tempImage.pixel(x,y) ); } } //create slideshow and thumbnail formats createImages(fullImage, &slideshowImage, &thumbnailImage, &paddedThumbnailImage, slideshowWidth, slideshowHeight); //store image and slideshow filenames imageLocation = filename; //image is being stored in temp location, needs saving! needsSaving = true; //set the subalbum as being modified subalbum->setModified(); return true; }

void Photo::setImageChecksum (  QString  val  )

Update image checksum. Definition at line 750 of file photo.cpp. References imageChecksum. Referenced by Album::exportSubalbumImages(). { imageChecksum = val; }

void Photo::setImageFilename (  QString  val  )

Sets the image filename. Definition at line 779 of file photo.cpp. References imageLocation. Referenced by Subalbum::addPhoto(), Album::exportSubalbumImages(), and Album::reorderSubalbumImages(). { imageLocation = val; }

void Photo::setInitialPhotoNumber (  int  val  )

Sets initial photo number. Definition at line 829 of file photo.cpp. References initialNumber. Referenced by Album::reorderSubalbumImages(). { initialNumber = val; }

void Photo::setInitialSubalbumNumber (  int  val  )

Sets initial subalbum number. Definition at line 834 of file photo.cpp. References initialSubalbumNumber. Referenced by Album::reorderSubalbumImages(). { initialSubalbumNumber = val; }

void Photo::setNeedsSavingVal (  bool  val  )

Sets if the image needs to be saved to its permanent location. Definition at line 809 of file photo.cpp. References needsSaving. Referenced by Album::exportSubalbumImages(). { needsSaving = val; }

void Photo::setNext (  Photo *  val  )

Sets pointer to next photo. Definition at line 258 of file photo.cpp. References next, Subalbum::setModified(), and subalbum. Referenced by Subalbum::addPhoto(), Subalbum::lazyAddPhoto(), Subalbum::photoMoved(), Subalbum::removePhoto(), and Subalbum::syncPhotoList(). { next = val; //set the subalbum as being modified subalbum->setModified(); }

void Photo::setSlideshowChecksum (  QString  val  )

Update slideshow checksum. Definition at line 745 of file photo.cpp. References slideshowChecksum. Referenced by Album::exportSubalbumImages(). { slideshowChecksum = val; }

void Photo::setSlideshowFilename (  QString  val  )

Sets the slideshow filename. Definition at line 784 of file photo.cpp. References slideshowLocation. Referenced by Subalbum::addPhoto(), Album::exportSubalbumImages(), and Album::reorderSubalbumImages(). { slideshowLocation = val; }

void Photo::setThumbnailChecksum (  QString  val  )

Update thumbnail checksum. Definition at line 740 of file photo.cpp. References thumbnailChecksum. Referenced by Album::exportSubalbumImages(). { thumbnailChecksum = val; }

void Photo::setThumbnailFilename (  QString  val  )

Sets the thumbnail filename. Definition at line 789 of file photo.cpp. References thumbnailLocation. Referenced by Album::exportSubalbumImages(), and Album::reorderSubalbumImages(). { thumbnailLocation = val; }

---

Member Data Documentation

QString Photo::description [private]

Longer description of subalbum. Definition at line 186 of file photo.h. Referenced by exportToXML(), getDescription(), importFromDisk(), Photo(), and setDescription().

QImage* Photo::fullImage [private]

Actual image. Definition at line 198 of file photo.h. Referenced by deallocateLargeImages(), getImage(), Photo(), rotate270(), rotate90(), setImage(), and ~Photo().

QString Photo::imageChecksum [private]

MD5 checksums, ued to determine if image/thumbnail have been changed. Definition at line 201 of file photo.h. Referenced by exportToXML(), getImageChecksum(), importFromDisk(), Photo(), and setImageChecksum().

QString Photo::imageLocation [private]

Image filename. Definition at line 206 of file photo.h. Referenced by flipHorizontally(), flipVertically(), getImage(), getImageFilename(), Photo(), rotate270(), rotate90(), setImage(), and setImageFilename().

int Photo::initialNumber [private]

Definition at line 177 of file photo.h. Referenced by flipHorizontally(), flipVertically(), getImage(), getInitialPhotoNumber(), Photo(), rotate270(), rotate90(), setImage(), and setInitialPhotoNumber().

int Photo::initialSubalbumNumber [private]

Definition at line 180 of file photo.h. Referenced by flipHorizontally(), flipVertically(), getImage(), getInitialSubalbumNumber(), Photo(), rotate270(), rotate90(), setImage(), and setInitialSubalbumNumber().

bool Photo::needsSaving [private]

Does the image need to be saved to the permanent location? Definition at line 215 of file photo.h. Referenced by flipHorizontally(), flipVertically(), getImage(), getNeedsSavingVal(), Photo(), rotate270(), rotate90(), setImage(), and setNeedsSavingVal().

Photo* Photo::next [private]

Pointer to next photo. Definition at line 183 of file photo.h. Referenced by getNext(), Photo(), and setNext().

QImage* Photo::paddedThumbnailImage [private]

A padded thumbnail used for subalbum layout. Definition at line 192 of file photo.h. Referenced by flipHorizontally(), flipVertically(), getImage(), Photo(), rotate270(), rotate90(), setImage(), and ~Photo().

QString Photo::slideshowChecksum [private]

Definition at line 202 of file photo.h. Referenced by exportToXML(), getSlideshowChecksum(), importFromDisk(), Photo(), and setSlideshowChecksum().

int Photo::slideshowHeight [private]

Unpadded height of slideshow image. Definition at line 221 of file photo.h. Referenced by actualSlideshowHeight(), flipHorizontally(), flipVertically(), Photo(), rotate270(), rotate90(), setActualSlideshowDimensions(), and setImage().

QImage* Photo::slideshowImage [private]

Slideshow iamge. Definition at line 195 of file photo.h. Referenced by deallocateLargeImages(), flipHorizontally(), flipVertically(), getImage(), Photo(), rotate270(), rotate90(), setImage(), and ~Photo().

QString Photo::slideshowLocation [private]

Slideshow filename. Definition at line 209 of file photo.h. Referenced by flipHorizontally(), flipVertically(), getImage(), getSlideshowFilename(), Photo(), rotate270(), rotate90(), setImage(), and setSlideshowFilename().

int Photo::slideshowWidth [private]

Unpadded width of slideshow image. Definition at line 218 of file photo.h. Referenced by actualSlideshowWidth(), flipHorizontally(), flipVertically(), Photo(), rotate270(), rotate90(), setActualSlideshowDimensions(), and setImage().

Subalbum* Photo::subalbum [private]

Subalbum photo is in. Definition at line 174 of file photo.h. Referenced by flipHorizontally(), flipVertically(), rotate270(), rotate90(), setDescription(), setImage(), and setNext().

QString Photo::thumbnailChecksum [private]

Definition at line 203 of file photo.h. Referenced by exportToXML(), getThumbnailChecksum(), importFromDisk(), Photo(), and setThumbnailChecksum().

QImage* Photo::thumbnailImage [private]

Thumbnail used for saving to disk. Definition at line 189 of file photo.h. Referenced by flipHorizontally(), flipVertically(), getImage(), Photo(), rotate270(), rotate90(), setImage(), and ~Photo().

QString Photo::thumbnailLocation [private]

Thumbnail filename. Definition at line 212 of file photo.h. Referenced by getThumbnailFilename(), Photo(), setImage(), and setThumbnailFilename().

---

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

• photo.h
• photo.cpp

---