ALabel Class Reference

#include <ALabel.h>

Inheritance diagram for ALabel:

[legend]Collaboration diagram for ALabel:

[legend]List of all members.

Signals
void	dropEventOccured (QDropEvent *e)
void	mousePress ()
	various mouse-click signals
void	mouseRelease ()
void	mouseDoubleClick ()
void	pixmapRemoved ()
Public Member Functions
	ALabel (QWidget *parent=0, const char *name=0, QPixmap *hoverOverImage=NULL, int setMethod=APPEAR_IMMEDIATELY, int removalMethod=DISAPPEAR_IMMEDIATELY, int resetMethod=APPEAR_IMMEDIATELY, int removalBeforeResetMethod=DISAPPEAR_IMMEDIATELY, int initDelay=130, int accel=50)
	create the label, optionally set a hover-over image (only displayed when pixmap for label is set and fully shown)
void	setAnimationMethods (int setMethod=APPEAR_IMMEDIATELY, int removalMethod=DISAPPEAR_IMMEDIATELY, int resetMethod=APPEAR_IMMEDIATELY, int removalBeforeResetMethod=DISAPPEAR_IMMEDIATELY)
	alter animation methods
void	setPixmap (const QPixmap &p)
	animates setting an image
void	removePixmap (bool forceImmediate=false)
	animates removing an image
Protected Member Functions
void	animatePixmap ()
	begin animating the pixmap
void	drawContents (QPainter *p)
void	enterEvent (QEvent *e)
void	leaveEvent (QEvent *e)
void	mousePressEvent (QMouseEvent *)
void	mouseReleaseEvent (QMouseEvent *)
void	mouseDoubleClickEvent (QMouseEvent *)
void	mouseMoveEvent (QMouseEvent *)
Private Slots
void	animate ()
Private Member Functions
void	internalRemovePixmap (bool forceImmediate=false)
void	internalSetPixmap (const QPixmap &p)
void	appendJob (QPixmap *pix)
void	cleanStack ()
Private Attributes
QImage *	pixStore
QImage *	resetPixStore
int	setMethod
int	removalMethod
int	removalBeforeResetMethod
int	resetMethod
int	initDelay
int	accel
int	minDelay
int	delay
int	animationType
int	step
QTimer *	timer
QTime	lastTime
QTime	currentTime
bool	drawHoverOverImage
QRect	hoverOverRect
QPixmap *	hoverOverImage
bool	imageShown
bool	handCursorShown
bool	animating
QMutex	animatingBoolMutex
bool	resettingImage
Action *	delayedActionHead
Action *	delayedActionTail
QMutex	queueMutex

---

Constructor & Destructor Documentation

ALabel::ALabel (  QWidget *  parent = 0, const char *  name = 0, QPixmap *  hoverOverImage = NULL, int  setMethod = APPEAR_IMMEDIATELY, int  removalMethod = DISAPPEAR_IMMEDIATELY, int  resetMethod = APPEAR_IMMEDIATELY, int  removalBeforeResetMethod = DISAPPEAR_IMMEDIATELY, int  initDelay = 130, int  accel = 50 )

create the label, optionally set a hover-over image (only displayed when pixmap for label is set and fully shown) Definition at line 25 of file ALabel.cpp. References animate(), animating, delayedActionHead, delayedActionTail, drawHoverOverImage, handCursorShown, imageShown, minDelay, pixStore, resetPixStore, resettingImage, and timer. : QLabel(parent,name) { delayedActionHead = NULL; delayedActionTail = NULL; //set animation defaults this->setMethod = setMethod; this->removalMethod = removalMethod; this->removalBeforeResetMethod = removalBeforeResetMethod; this->resetMethod = resetMethod; //set hover over image this->hoverOverImage = hoverOverImage; drawHoverOverImage = false; setMouseTracking(true); handCursorShown = false; //by default image is not shown, we are not animating, nor resetting the image imageShown = false; animating = false; resettingImage = false; pixStore = NULL; resetPixStore = NULL; //don't clear pixmap area before painting, prevents flicker setWFlags(WRepaintNoErase); //set delay defaults this->initDelay = initDelay; this->accel = accel; this->minDelay = 1; //create timer object and setup signals timer = new QTimer(); connect(timer, SIGNAL(timeout()), this, SLOT(animate()) ); }

---

Member Function Documentation

void ALabel::animate (   )  [private, slot]

Definition at line 193 of file ALabel.cpp. References animatePixmap(), animating, animatingBoolMutex, animationType, b, cleanStack(), currentTime, delay, delayedActionHead, delayedActionTail, DISAPPEAR_IMMEDIATELY, FADE_TRANSITION, Action::getImage(), Action::getNext(), imageShown, internalRemovePixmap(), internalSetPixmap(), lastTime, pixmapRemoved(), pixStore, queueMutex, resetPixStore, resettingImage, SLIDE_IN_LEFT, SLIDE_OUT_LEFT, step, and timer. Referenced by ALabel(), and animatePixmap(). { //--------------------------------- //backup last # of columns shown int lastStep = step; //--------------------------------- //determine new number of columns to be shown if(animationType == APPEAR_IMMEDIATELY) step = pixStore->width(); else if(animationType == DISAPPEAR_IMMEDIATELY) step = 0; else { //determine # of ms that have passed since last redraw currentTime.start(); double ms = lastTime.msecsTo(currentTime); //determine increment int inc = (int)(ms/(delay+1)); if(animationType == SLIDE_OUT_LEFT || animationType == SLIDE_OUT_RIGHT) { inc = -inc; } //if increment is not zero then update last time if(inc != 0) { lastTime = currentTime; } //update number of columns shown step = step + inc; //boundary conditions if( animationType == FADE_TRANSITION) { if(step > 100) step = 100; } else { if(step > pixStore->width()) step = pixStore->width(); else if(step < 0) step = 0; } } //--------------------------------- //if percentage of frade has changed then redraw if(animationType == FADE_TRANSITION) { if(step != lastStep) { //compute intermediate image resolution double w1 = pixStore->width(); double h1 = pixStore->height(); double w2 = resetPixStore->width(); double h2 = resetPixStore->height(); double alpha = ((double)step) / 100.0; int w = (int) ( w1 + (w2-w1)*alpha ); int h = (int) ( h1 + (h2-h1)*alpha ); //resize old and new images QImage oldImg = pixStore->scale( w, h ); QImage newImg = resetPixStore->scale( w, h ); //scale each image by alpha (step/100) and 1-alpha and combine int maxDepth = pixStore->depth(); if(resetPixStore->depth() > maxDepth) maxDepth = resetPixStore->depth(); QImage tmpImage(w, h, maxDepth); int x,y; for(x = 0; x<w; x++) { for(y = 0; y<h; y++) { QRgb v1 = oldImg.pixel(x,y); QRgb v2 = newImg.pixel(x,y); int r = (int) (alpha* qRed(v2) + (1-alpha)*qRed(v1)); int g = (int) (alpha* qGreen(v2) + (1-alpha)*qGreen(v1)); int b = (int) (alpha* qBlue(v2) + (1-alpha)*qBlue(v1)); tmpImage.setPixel(x, y, qRgb(r,g,b) ); } } //set image shown to this interpolated image QPixmap tmpPixmap(step, pixStore->height() ); tmpPixmap.convertFromImage( tmpImage ); QLabel::setPixmap( tmpPixmap ); //I've noticed when we replace images with ones which are shorter (height wise) some pixels //are left behind. this is annoying. a quick fix is to so a erase repaint in this situation. //another kludgly (but flickerless) improvement woudl be to create a pixmap that is the //same size as the current but paints the bottom and top edges with the background color. //I honestly think this is a bug in Qt that Trolltech needs to address. Maybe I should report it to them. if(h2 < h1) repaint(true); else repaint(false); } } //if the number of cols to be shown has changed then redraw else if(step != lastStep && ( animationType != DISAPPEAR_IMMEDIATELY || (animationType == DISAPPEAR_IMMEDIATELY && !resettingImage) ) ) { //draw empty image if(step == 0) { QLabel::setPixmap( NULL ); emit pixmapRemoved(); repaint(true); } //draw full image else if(step == pixStore->width() ) { QLabel::setPixmap( *pixStore ); repaint(false); } //draw a portion the image else { //construct temp image QImage tmpImage(step, pixStore->height(), pixStore->depth() ); int x,y; for(x = 0; x<step; x++) { for(y = 0; y<pixStore->height(); y++) { if(animationType == SLIDE_IN_LEFT || animationType == SLIDE_OUT_LEFT) { tmpImage.setPixel( x, y, pixStore->pixel(pixStore->width()-step+x,y) ); } else { tmpImage.setPixel( x, y, pixStore->pixel(x,y) ); } } //end for y } //end for x //set label to use temp image (a portion of the full image) QPixmap tmpPixmap(step, pixStore->height() ); tmpPixmap.convertFromImage( tmpImage ); QLabel::setPixmap( tmpPixmap ); if(animationType == SLIDE_OUT_LEFT || animationType == SLIDE_OUT_RIGHT) repaint(true); else repaint(false); } } //--------------------------------- //not done animating, reiterate if( ((animationType == SLIDE_IN_LEFT || animationType == SLIDE_IN_RIGHT) && step < pixStore->width()) || ((animationType == SLIDE_OUT_LEFT || animationType == SLIDE_OUT_RIGHT) && step > 0) || (animationType == FADE_TRANSITION && step < 100) ) { //update speed delay = delay - accel; if(delay < minDelay) delay = minDelay; //restart timer timer->start( delay, TRUE ); } //--------------------------------- //done animating.... else { //If we just removed the image then delete the old pixStore object if(step == 0) { imageShown = false; delete pixStore; pixStore = NULL; } else { imageShown = true; } //if we are actually in the middle of a reset action then we've //just finished removing the old image, now it's time to start setting the new image if(resettingImage && animationType != FADE_TRANSITION) { resettingImage = false; if(pixStore) { // cout << "ERROR! Leak detected!\n"; delete pixStore; pixStore = NULL; } pixStore = resetPixStore; resetPixStore = NULL; animationType = resetMethod; animatePixmap(); } //else truely done else { //we were running a fade effect then delete old pixmap and repalce it with new one if( animationType == FADE_TRANSITION ) { resettingImage = false; delete pixStore; pixStore = resetPixStore; resetPixStore = NULL; } //check to see pending animations exist, if so pop off next action from list queueMutex.lock(); //simplify list of pending actions cleanStack(); if(delayedActionHead == NULL) { //done! queueMutex.unlock(); animatingBoolMutex.lock(); animating = false; animatingBoolMutex.unlock(); return; } //ok, we're not done, pop off first entry from queue, then start up actual job Action* currAction = delayedActionHead; delayedActionHead = delayedActionHead->getNext(); if(delayedActionHead == NULL) delayedActionTail = NULL; queueMutex.unlock(); //start job if(currAction->getImage() == NULL) internalRemovePixmap(); else internalSetPixmap( *currAction->getImage() ); //free old action object delete currAction; } } //--------------------------------------- }

void ALabel::animatePixmap (   )  [protected]

begin animating the pixmap Definition at line 171 of file ALabel.cpp. References animate(), animationType, delay, lastTime, pixStore, SLIDE_OUT_LEFT, SLIDE_OUT_RIGHT, and step. Referenced by animate(), internalRemovePixmap(), and internalSetPixmap(). { //set the step paramater. for slide transitions this is the number //of columns to be displayed. for fade transitions this is what percentage //of the fade we have completed so start out at 1. if(animationType == SLIDE_OUT_LEFT || animationType == SLIDE_OUT_RIGHT || animationType == DISAPPEAR_IMMEDIATELY) { step = pixStore->width()-1; } else { step = 1; } //set initial delay/speed delay = initDelay; //find current time, used to decide how many new columns to reveal in first iteration lastTime.start(); //begin animation animate(); }

void ALabel::appendJob (  QPixmap *  pix  )  [private]

Definition at line 556 of file ALabel.cpp. References delayedActionHead, delayedActionTail, and Action::setNext(). Referenced by removePixmap(), and setPixmap(). { Action* newAct = new Action(pix); if(delayedActionHead == NULL) delayedActionHead = newAct; else delayedActionTail->setNext( newAct ); delayedActionTail = newAct; }

void ALabel::cleanStack (   )  [private]

Definition at line 567 of file ALabel.cpp. References delayedActionHead, delayedActionTail, Action::getImage(), Action::getNext(), and pixStore. Referenced by animate(). { //if stack empty already clean if(delayedActionHead == NULL) return; //if no image currently displayed, pop off all remove actions from head of list if(pixStore == NULL) { Action* currAction = delayedActionHead; while(currAction != NULL && currAction->getImage() == NULL) { Action* next = currAction->getNext(); delete currAction; currAction = next; } delayedActionHead = currAction; if(currAction == NULL) delayedActionTail = NULL; } //if one pending operations no simplifications possible if(delayedActionHead == delayedActionTail) return; //if last action is a set operation then remove all other entries if(delayedActionTail->getImage() != NULL) { Action* temp = delayedActionHead; delayedActionHead = delayedActionTail; while(temp != delayedActionHead) { Action* next = temp->getNext(); delete temp; temp = next; } return; } //last action is a remove operation, if no current image then cull entire stack if(pixStore == NULL) { Action* temp = delayedActionHead; while(temp != NULL) { Action* next = temp->getNext(); delete temp; temp = next; } delayedActionHead = NULL; delayedActionTail = NULL; return; } //else remove all but last pending operations since final remove action will remove current image else { Action* temp = delayedActionHead; while(temp != delayedActionTail) { Action* next = temp->getNext(); delete temp; temp = next; } delayedActionHead = delayedActionTail; return; } }

void ALabel::drawContents (  QPainter *  p  )  [protected]

Definition at line 446 of file ALabel.cpp. References animating, hoverOverImage, hoverOverRect, and imageShown. { //draw conents of label QLabel::drawContents(p); //if animation complete and image is being shown, draw hover over image if(!animating && imageShown && drawHoverOverImage) { QRect r = style().itemRect( p, contentsRect(), alignment(), isEnabled(), pixmap(), text()); int minDim = r.width(); if(r.height() < minDim) minDim = r.height(); if(minDim > hoverOverImage->width()) { r.setLeft( r.right() - hoverOverImage->width() ); r.setBottom( r.top() + hoverOverImage->height() ); hoverOverRect = r; p->drawPixmap( r, *hoverOverImage); } else { QImage resizedImage = hoverOverImage->convertToImage().scale(minDim, minDim); QPixmap resizedPixmap(resizedImage); r.setLeft( r.right() - resizedPixmap.width() ); r.setBottom( r.top() + resizedPixmap.height() ); hoverOverRect = r; p->drawPixmap( r, resizedPixmap); } } }

void ALabel::dropEventOccured (  QDropEvent *  e  )  [signal]

void ALabel::enterEvent (  QEvent *  e  )  [protected]

Definition at line 478 of file ALabel.cpp. References drawHoverOverImage. { if(hoverOverImage) { drawHoverOverImage = true; repaint( false ); } }

void ALabel::internalRemovePixmap (  bool  forceImmediate = false  )  [private]

Definition at line 160 of file ALabel.cpp. References animatePixmap(), and animationType. Referenced by animate(), and removePixmap(). { //set animation method and animate if(forceImmediate) animationType = DISAPPEAR_IMMEDIATELY; else animationType = removalMethod; animatePixmap(); }

void ALabel::internalSetPixmap (  const QPixmap &  p  )  [private]

Definition at line 100 of file ALabel.cpp. References animatePixmap(), animationType, pixStore, resetPixStore, and resettingImage. Referenced by animate(), and setPixmap(). { //if previous image already present remove it first if(pixStore) { resettingImage = true; //backup new set image to be retrieved later if(resetPixStore) { // cout << "LEAK DETECTED when trying to resetPixStore\n"; delete resetPixStore; } resetPixStore = new QImage(p.convertToImage()); //set animation method animationType = removalBeforeResetMethod; //remove old pixmap animatePixmap(); } //else immediately set image else { resettingImage = false; //set pixmap store and animate setting it pixStore = new QImage(p.convertToImage()); animationType = setMethod; animatePixmap(); } }

void ALabel::leaveEvent (  QEvent *  e  )  [protected]

Definition at line 487 of file ALabel.cpp. References drawHoverOverImage. { if(hoverOverImage) { drawHoverOverImage = false; repaint(false); } }

void ALabel::mouseDoubleClick (   )  [signal]

Referenced by mouseDoubleClickEvent().

void ALabel::mouseDoubleClickEvent (  QMouseEvent *   )  [protected]

Definition at line 530 of file ALabel.cpp. References mouseDoubleClick(). { emit mouseDoubleClick(); }

void ALabel::mouseMoveEvent (  QMouseEvent *   )  [protected]

Definition at line 533 of file ALabel.cpp. References handCursorShown, and hoverOverRect. { //need rect so draw hover over image must exist before any checks can occur if( !drawHoverOverImage ) return; //if hand not shown but over hover over image then turn hand cursor on if( !handCursorShown && hoverOverRect.contains( e->x(), e->y() ) ) { setCursor( QCursor( Qt::PointingHandCursor ) ); handCursorShown = true; return; } //if hand cursor shown but nolonger over hover over image set cursor back to normal if( handCursorShown && !hoverOverRect.contains( e->x(), e->y() ) ) { setCursor( QCursor( Qt::ArrowCursor ) ); handCursorShown = false; return; } }

void ALabel::mousePress (   )  [signal]

various mouse-click signals Referenced by mousePressEvent().

void ALabel::mousePressEvent (  QMouseEvent *   )  [protected]

Definition at line 496 of file ALabel.cpp. References mousePress(). { emit mousePress(); }

void ALabel::mouseRelease (   )  [signal]

Referenced by mouseReleaseEvent().

void ALabel::mouseReleaseEvent (  QMouseEvent *   )  [protected]

Definition at line 499 of file ALabel.cpp. References hoverOverImage, mouseRelease(), and removePixmap(). { //if there is no hover over image then ignore event if( hoverOverImage == NULL ) return; QPainter* p = new QPainter(); QRect r = style().itemRect( p, contentsRect(), alignment(), isEnabled(), pixmap(), text()); delete p; int minDim = r.width(); if(r.height() < minDim) minDim = r.height(); if(minDim > hoverOverImage->width()) { r.setLeft( r.right() - hoverOverImage->width() ); r.setBottom( r.top() + hoverOverImage->height() ); } else { QImage resizedImage = hoverOverImage->convertToImage().scale(minDim, minDim); QPixmap resizedPixmap(resizedImage); r.setLeft( r.right() - resizedPixmap.width() ); r.setBottom( r.top() + resizedPixmap.height() ); } if(r.contains( e->pos() ) ) { removePixmap(); emit mouseRelease(); } }

void ALabel::pixmapRemoved (   )  [signal]

Referenced by animate().

void ALabel::removePixmap (  bool  forceImmediate = false  )

animates removing an image Definition at line 132 of file ALabel.cpp. References animating, animatingBoolMutex, appendJob(), delayedActionHead, internalRemovePixmap(), pixStore, and queueMutex. Referenced by TitleWidget::loadAlbum(), mouseReleaseEvent(), TitleWidget::newAlbum(), TitleWidget::refreshCollectionAnnotations(), HelpWindow::setPage(), and TitleWidget::updateAlbumAnnotations(). { //get locks on queues queueMutex.lock(); animatingBoolMutex.lock(); //if currently animating then append job to queue if(animating || delayedActionHead != NULL) { appendJob( NULL ); animatingBoolMutex.unlock(); queueMutex.unlock(); return; } //else set animating to true, actually initiate job (only if no image currently exists) else { //only remove image if image currently exists if(pixStore != NULL) animating = true; animatingBoolMutex.unlock(); queueMutex.unlock(); if(animating) internalRemovePixmap( forceImmediate ); } }

void ALabel::setAnimationMethods (  int  setMethod = APPEAR_IMMEDIATELY, int  removalMethod = DISAPPEAR_IMMEDIATELY, int  resetMethod = APPEAR_IMMEDIATELY, int  removalBeforeResetMethod = DISAPPEAR_IMMEDIATELY )

alter animation methods Definition at line 67 of file ALabel.cpp. Referenced by TitleWidget::useAnimation(). { //set animation defaults this->setMethod = setMethod; this->removalMethod = removalMethod; this->removalBeforeResetMethod = removalBeforeResetMethod; this->resetMethod = resetMethod; }

void ALabel::setPixmap (  const QPixmap &  p  )

animates setting an image Definition at line 77 of file ALabel.cpp. References animating, animatingBoolMutex, appendJob(), delayedActionHead, internalSetPixmap(), and queueMutex. Referenced by HelpWindow::HelpWindow(), TitleWidget::refreshCollectionAnnotations(), TitleWidget::setAlbumImage(), TitleWidget::setSubalbumImage(), and TitleWidget::updateAlbumAnnotations(). { //get locks on queues queueMutex.lock(); animatingBoolMutex.lock(); //if currently animating then append job to queue if(animating || delayedActionHead != NULL) { appendJob(new QPixmap(p)); animatingBoolMutex.unlock(); queueMutex.unlock(); return; } //else set animating to true, actually initiate job else { animating = true; animatingBoolMutex.unlock(); queueMutex.unlock(); internalSetPixmap( p ); } }

---

Member Data Documentation

int ALabel::accel [private]

Definition at line 105 of file ALabel.h.

bool ALabel::animating [private]

Definition at line 126 of file ALabel.h. Referenced by ALabel(), animate(), drawContents(), removePixmap(), and setPixmap().

QMutex ALabel::animatingBoolMutex [private]

Definition at line 127 of file ALabel.h. Referenced by animate(), removePixmap(), and setPixmap().

int ALabel::animationType [private]

Definition at line 105 of file ALabel.h. Referenced by animate(), animatePixmap(), internalRemovePixmap(), and internalSetPixmap().

QTime ALabel::currentTime [private]

Definition at line 110 of file ALabel.h. Referenced by animate().

int ALabel::delay [private]

Definition at line 105 of file ALabel.h. Referenced by animate(), and animatePixmap().

Action* ALabel::delayedActionHead [private]

Definition at line 133 of file ALabel.h. Referenced by ALabel(), animate(), appendJob(), cleanStack(), removePixmap(), and setPixmap().

Action* ALabel::delayedActionTail [private]

Definition at line 134 of file ALabel.h. Referenced by ALabel(), animate(), appendJob(), and cleanStack().

bool ALabel::drawHoverOverImage [private]

Definition at line 113 of file ALabel.h. Referenced by ALabel(), enterEvent(), and leaveEvent().

bool ALabel::handCursorShown [private]

Definition at line 123 of file ALabel.h. Referenced by ALabel(), and mouseMoveEvent().

QPixmap* ALabel::hoverOverImage [private]

Definition at line 117 of file ALabel.h. Referenced by drawContents(), and mouseReleaseEvent().

QRect ALabel::hoverOverRect [private]

Definition at line 114 of file ALabel.h. Referenced by drawContents(), and mouseMoveEvent().

bool ALabel::imageShown [private]

Definition at line 120 of file ALabel.h. Referenced by ALabel(), animate(), and drawContents().

int ALabel::initDelay [private]

Definition at line 105 of file ALabel.h.

QTime ALabel::lastTime [private]

Definition at line 110 of file ALabel.h. Referenced by animate(), and animatePixmap().

int ALabel::minDelay [private]

Definition at line 105 of file ALabel.h. Referenced by ALabel().

QImage* ALabel::pixStore [private]

Definition at line 96 of file ALabel.h. Referenced by ALabel(), animate(), animatePixmap(), cleanStack(), internalSetPixmap(), and removePixmap().

QMutex ALabel::queueMutex [private]

Definition at line 135 of file ALabel.h. Referenced by animate(), removePixmap(), and setPixmap().

int ALabel::removalBeforeResetMethod [private]

Definition at line 101 of file ALabel.h.

int ALabel::removalMethod [private]

Definition at line 100 of file ALabel.h.

int ALabel::resetMethod [private]

Definition at line 102 of file ALabel.h.

QImage * ALabel::resetPixStore [private]

Definition at line 96 of file ALabel.h. Referenced by ALabel(), animate(), and internalSetPixmap().

bool ALabel::resettingImage [private]

Definition at line 130 of file ALabel.h. Referenced by ALabel(), animate(), and internalSetPixmap().

int ALabel::setMethod [private]

Definition at line 99 of file ALabel.h.

int ALabel::step [private]

Definition at line 106 of file ALabel.h. Referenced by animate(), and animatePixmap().

QTimer* ALabel::timer [private]

Definition at line 109 of file ALabel.h. Referenced by ALabel(), and animate().

---

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

• ALabel.h
• ALabel.cpp

---