Interface for editing photo. More...

#include <editingInterface.h>

Inheritance diagram for EditingInterface:

Collaboration diagram for EditingInterface:

Public Slots
void	handleSelectionChanged ()

void	handleAspectRatioChanged ()

void	setFocus ()

Signals
void	photoModified ()

Public Member Functions
	EditingInterface (QWidget parent=0, const char name=0)
	Constructs layout.

	~EditingInterface ()

void	setPhoto (Subalbum collection, Photo photo)
	Sets the photo pointer and constructs scaled qimage's for painting.

Photo *	getPhoto ()
	Returns a pointer to the currently selected photo.

bool	currentPhotoRevertable ()

void	revertCurrentPhoto ()
	reverts current photo and updates display

Protected Member Functions
void	keyPressEvent (QKeyEvent *e)

Private Slots
void	showPrevPhoto ()
	Show prev photo.

void	showNextPhoto ()
	Show next photo.

void	showFirstPhoto ()
	Show first photo.

void	showLastPhoto ()
	Show last photo.

void	rotateRight ()
	Rotate image right 90 degrees.

void	rotateLeft ()
	Rotate image left 90 degrees.

void	flipHorizontal ()
	Flip image horizontally.

void	startCorrectTilt ()
	Enter correct image tilt mode.

void	finishCorrectTilt (QPoint p1, QPoint p2)
	Finish correcting and image's tilt.

void	flipVertical ()
	Flip image vertically.

void	selectAspectRatio ()
	Aspect ratio selection changed.

void	screenResolutionChanged ()
	Update recorded screen resolution and selection if necessary.

void	rotateSelection ()
	Rotate current selection.

void	crop ()
	Cropped image.

void	enhanceContrast ()
	Enhance image contrast.

void	colorBalance ()
	Improve color balance.

void	removeRedeye ()
	Applies redeye removal.

void	tuneLevels ()
	Opens levels editor for manual histogram and brightness/contrast adjustments.

void	adjustGrain ()
	Opens image grain editor.

void	selectEffect ()
	Effect seletion changed.

void	applyEffect ()
	Apply selected effect.

void	returnAction ()
	Exit editing interface.

Private Member Functions
void	showNextPrevFirstLastPhoto (Photo *newPhoto)
	Utility method for show prev/next photos.

void	rotateFlip (TRANSFORM_CODE rotationFlipType)
	Utility method for rotation + flip slots.

bool	findSelection (QPoint &topLeft, QPoint &bottomRight)
	Finds the selected region of the image.

void	selectAll (QPoint &topLeft, QPoint &bottomRight)
	Return coordinates that select entire image.

QImage *	applyEffect (QString filename, ManipulationOptions *options=NULL)
	utlity function for apply effect and preview effect slots

void	applyImageUpdate (QImage *editedImage, bool resetSelection)
	Applies update to image.

Private Attributes
ClickableLabel *	previousButton

ClickableLabel *	nextButton

SelectionInterface *	selectionInterface
	This widget scales and displays the photo to fit the available screen space, and provides extensive support for selecting regions of the photo for editing/cropping.

QComboBox *	aspectRatios
	Widget for selection aspect ratio to crop to.

QComboBox *	orientations

int	displayResolutionIndex
	Index for screen resolution, needed if this value pair changes during program executing.

QSize *	aspectRatioValues
	array of common aspect ratios to crop to

double *	maxDimensions

bool	selectionRotated
	state variable indicating if the user wants to use a rotate aspect ratio

QToolButton *	correctTiltButton
	The start tilt button is disabled while a line is being selected.

QToolButton *	cropButton
	The crop buttons is disabled when no seletion is present.

ClickableLabel *	redEyeReductionButton
	The red eye reduction button is disabled when no selection is present.

QComboBox *	effectsList
	List of effects that can be applied to photos.

QPushButton *	applyEffectButton
	The apply effect button is disabled when no effect has been chosen.

QLabel *	effectPreview
	Label that shows preview of effect.

Subalbum *	collection
	========== Pointer to backend collection

Photo *	photo
	Pointer to backend photo.

QString	effectPreviewImageFilename
	Path to scaled down version of image for fast generation of previews of effects.

LayoutWidget *	layout
	Pointer to the parent layout widget.

int	displayWidth
	Dimension of photo in display coordinates.

int	displayHeight

int	imageWidth
	Dimension of photo in image coordinates.

int	imageHeight

Detailed Description

Interface for editing photo.

Definition at line 56 of file editingInterface.h.

Constructor & Destructor Documentation

◆ EditingInterface()

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

Constructs layout.

Definition at line 76 of file editingInterface.cpp.

                                 : QWidget(parent,name)
{
  //create a smaller font for drawing various labels and items
  QFont smallerFont = font();
  smallerFont.setPointSize( smallerFont.pointSize() - 1 );  
 
  setFocusPolicy(Qt::StrongFocus);
 
  //set photo pointer to null by default
  photo = NULL;
 
  //store layout pointer
  layout = (LayoutWidget*)parent;
 
  //----------  
  //Construct photo frame that houses photo being edited and prev and next buttons
  Q3Frame* photoFrame = new Q3Frame(this, "photoFrame" );
  
  //Construct the frame that houses all the controls
  Q3Frame* controlsFrame = new Q3Frame(this, "controlsFrame");
 
  //Place photo fram and control widgets in a top level grid
  Q3GridLayout* mainGrid = new Q3GridLayout( this, 3, 3, 0 );
  mainGrid->addWidget( photoFrame, 0, 1 );
  mainGrid->setRowStretch(0, 1);
  mainGrid->addMultiCellWidget( controlsFrame, 1,1, 0,2 );
  mainGrid->setRowSpacing( 2, WIDGET_SPACING );
  //----------  
  //Previous photo button
  previousButton = new ClickableLabel( photoFrame, "previousButton" );
  previousButton->setPixmap( QPixmap(QString(IMAGE_PATH)+"buttonIcons/previous.png") ); 
  connect( previousButton, SIGNAL(clicked()), SLOT(showPrevPhoto()) );    
 
  //Create widget for displaying and selecting regions of the current photo
  selectionInterface = new SelectionInterface( photoFrame, "selectionInterface" );
  connect( selectionInterface, SIGNAL( selectionChanged() ), this, SLOT( handleSelectionChanged() ) );
  connect( selectionInterface, SIGNAL( aspectRatioChanged() ), this, SLOT( handleAspectRatioChanged() ) );
  connect( selectionInterface, SIGNAL( ctrlClick() ), this, SLOT( rotateSelection() ) );
  
  //Next photo button
  nextButton = new ClickableLabel( photoFrame, "nextButton" );
  nextButton->setPixmap( QPixmap(QString(IMAGE_PATH)+"buttonIcons/next.png") ); 
  connect( nextButton, SIGNAL(clicked()), SLOT(showNextPhoto()) );    
 
  //Place above widgets in grid, allow seletion interface to take up extra room
  Q3GridLayout* selectionGrid = new Q3GridLayout( photoFrame, 1, 5, 0 );
  selectionGrid->setColSpacing( 0, WIDGET_SPACING );
  selectionGrid->addWidget( previousButton,     0, 1, Qt::AlignCenter );
  selectionGrid->addWidget( selectionInterface, 0, 2 );
  selectionGrid->setColStretch( 2, 1 );
  selectionGrid->addWidget( nextButton,         0, 3, Qt::AlignCenter );
  selectionGrid->setColSpacing( 4, WIDGET_SPACING );
  selectionGrid->setSpacing( WIDGET_SPACING );
  //-----------
  //construct the frames each set of controls is placed in
  Q3HGroupBox* frameControls   = new Q3HGroupBox( tr("Frame"),   controlsFrame, "frameControls"   );
  frameControls->setAlignment( Qt::AlignHCenter );
  frameControls->setInsideMargin( WIDGET_SPACING );
 
  Q3HGroupBox* enhanceControls = new Q3HGroupBox( tr("Enhance"), controlsFrame, "enhanceControls" );
  enhanceControls->setAlignment( Qt::AlignHCenter ); 
  enhanceControls->setInsideMargin( WIDGET_SPACING );
  
  Q3HGroupBox* manipulateControls = new Q3HGroupBox( tr("Manipulate"), controlsFrame, "applyEffect" );
  manipulateControls->setAlignment( Qt::AlignHCenter );
  manipulateControls->setInsideMargin( WIDGET_SPACING );
      
  //layout groups of controls
  Q3GridLayout* controlsGrid = new Q3GridLayout( controlsFrame, 1, 5, 0 );
  controlsGrid->addWidget( frameControls,      0, 1 );  
  controlsGrid->addWidget( enhanceControls,    0, 2 );  
  controlsGrid->addWidget( manipulateControls, 0, 3 );  
  
  controlsGrid->setSpacing( WIDGET_SPACING );    
  controlsGrid->setColSpacing(0, WIDGET_SPACING );
  controlsGrid->setColStretch(0, 1);
  controlsGrid->setColSpacing(4, WIDGET_SPACING );
  controlsGrid->setColStretch(4, 1);
  
  //----------   
  //Frame Controls
  //----------    
  Q3Frame* frameControlsFrame = new Q3Frame( frameControls );
 
  //-----
  //rotate and flip buttons
  Q3Frame* rotateFlipFrame = new Q3Frame( frameControlsFrame );
  
  QToolButton* rotateRightButton = new QToolButton( rotateFlipFrame, "rotateRight" );
  rotateRightButton->setIconSet( QPixmap(QString(IMAGE_PATH)+"buttonIcons/rotate90.png") );
  rotateRightButton->setSizePolicy( QSizePolicy::Fixed, QSizePolicy::Fixed );
  connect( rotateRightButton, SIGNAL(clicked()), SLOT(rotateRight()) );
  QToolTip::add( rotateRightButton, tr("Rotate clockwise") );  
  
  QToolButton* rotateLeftButton = new QToolButton( rotateFlipFrame, "rotateLeft" );
  rotateLeftButton->setIconSet( QPixmap(QString(IMAGE_PATH)+"buttonIcons/rotate270.png") ); 
  rotateLeftButton->setSizePolicy( QSizePolicy::Fixed, QSizePolicy::Fixed );
  connect( rotateLeftButton, SIGNAL(clicked()), SLOT(rotateLeft()) );
  QToolTip::add( rotateLeftButton, tr("Rotate counterclockwise") );  
 
  QToolButton* flipHorizontalButton = new QToolButton( rotateFlipFrame, "flipHorizontal" );
  flipHorizontalButton->setIconSet( QPixmap(QString(IMAGE_PATH)+"buttonIcons/flipHorizontally.png") );
  flipHorizontalButton->setSizePolicy( QSizePolicy::Fixed, QSizePolicy::Fixed );
  connect( flipHorizontalButton, SIGNAL(clicked()), SLOT(flipHorizontal()) );
  QToolTip::add( flipHorizontalButton, tr("Flip horizontally") );  
  
  QToolButton* flipVerticalButton = new QToolButton( rotateFlipFrame, "flipVertical" );
  flipVerticalButton->setIconSet( QPixmap(QString(IMAGE_PATH)+"buttonIcons/flipVertically.png") ); 
  flipVerticalButton->setSizePolicy( QSizePolicy::Fixed, QSizePolicy::Fixed );
  connect( flipVerticalButton, SIGNAL(clicked()), SLOT(flipVertical()) );  
  QToolTip::add( flipVerticalButton, tr("Flip vertically") );  
  
  correctTiltButton = new QToolButton( rotateFlipFrame, "correctTilt" );
  correctTiltButton->setIconSet( QPixmap(QString(IMAGE_PATH)+"buttonIcons/correctTilt.png") ); 
  correctTiltButton->setSizePolicy( QSizePolicy::Fixed, QSizePolicy::Fixed );
  
  connect( correctTiltButton, SIGNAL(clicked()), SLOT(startCorrectTilt()) );
 
  connect( selectionInterface, SIGNAL(lineSelected(QPoint, QPoint)),
           this, SLOT(finishCorrectTilt( QPoint, QPoint)) );
 
  QToolTip::add( correctTiltButton, tr("Correct tilt") );  
 
  //Place buttons in grid
  Q3GridLayout* rotateFlipGrid = new Q3GridLayout( rotateFlipFrame, 1, 5, 0 );
  rotateFlipGrid->setSpacing(TIGHT_WIDGET_SPACING);  
  rotateFlipGrid->addWidget( rotateRightButton,    0, 0 );
  rotateFlipGrid->addWidget( rotateLeftButton,     0, 1 );
  rotateFlipGrid->addWidget( flipHorizontalButton, 0, 2 );
  rotateFlipGrid->addWidget( flipVerticalButton,   0, 3 );
  rotateFlipGrid->addWidget( correctTiltButton,    0, 4 );
  //-----
  //aspect ratio selection and crop controls
  aspectRatios = new QComboBox( frameControlsFrame );
  aspectRatios->setFont( smallerFont );
  connect( aspectRatios, SIGNAL(activated(int)), this, SLOT(selectAspectRatio()) );  
  aspectRatioValues = new QSize[8];
  maxDimensions = new double[8];
  int curAspectRatio = 0;
  //--
  aspectRatios->insertItem( tr("Custom") );
  maxDimensions[curAspectRatio] = -1.0;
  aspectRatioValues[curAspectRatio++] = QSize( -1, -1 );
  //--  
  aspectRatios->insertItem( tr("Photo (3.5 x 5)") );
  maxDimensions[curAspectRatio] = 5.0;
  aspectRatioValues[curAspectRatio++] = QSize( 10, 7 );
  //--  
  aspectRatios->insertItem( tr("Photo (4 x 6)") );
  maxDimensions[curAspectRatio] = 6.0;
  aspectRatioValues[curAspectRatio++] = QSize( 6, 4 );
  //--  
  aspectRatios->insertItem( tr("Photo (5 x 7)") );
  maxDimensions[curAspectRatio] = 7.0;
  aspectRatioValues[curAspectRatio++] = QSize( 7, 5 );
  //--  
  aspectRatios->insertItem( tr("Photo (8 x 10)") );
  maxDimensions[curAspectRatio] = 10.0;
  aspectRatioValues[curAspectRatio++] = QSize( 10, 8 );
  //--  
  aspectRatios->insertItem( tr("Postcard") );
  maxDimensions[curAspectRatio] = 6.0;
  aspectRatioValues[curAspectRatio++] = QSize( 6, 4 );
  //--  
  aspectRatios->insertItem( tr("Wallet") );
  maxDimensions[curAspectRatio] = 3.0;
  aspectRatioValues[curAspectRatio++] = QSize( 3, 2 );
  //--  
  aspectRatios->insertItem( tr("Desktop") );
  displayResolutionIndex = curAspectRatio;
  maxDimensions[curAspectRatio] = -1.0;
  aspectRatioValues[curAspectRatio++] = qApp->desktop()->screenGeometry().size();
  //--  
  //connect signal emitted when screen resolution changes 
  //so as to update this stored value (and selction if necessary)
  connect( qApp->desktop(), SIGNAL( resized(int)), this, SLOT(screenResolutionChanged()) );
 
  QToolTip::add( aspectRatios, tr("Select region for cropping using a particular aspect ratio") );  
 
  QLabel* aspectRatioLabel = new QLabel( tr("Aspect Ratio"), frameControlsFrame );
  aspectRatioLabel->setFont( smallerFont );
  //--
 
  //Crop button
  cropButton = new QToolButton( frameControlsFrame );
  QIcon cropIcon;
  cropIcon.setPixmap( QString(IMAGE_PATH)+"buttonIcons/crop.png",
                      QIcon::Automatic,
                      QIcon::Normal );
                       
  cropIcon.setPixmap( QString(IMAGE_PATH)+"buttonIcons/crop_disabled.png",
                      QIcon::Automatic,
                      QIcon::Disabled );
  cropButton->setIconSet( cropIcon );
  connect( cropButton, SIGNAL(clicked()), SLOT(crop()) );
  QToolTip::add( cropButton, tr("Crop photo to selected region") );  
 
  QLabel* cropLabel = new QLabel( tr("Crop"), frameControlsFrame );
  cropLabel->setFont( smallerFont );  
  
  //--  
 
  //Place frame controls in a grid
  Q3GridLayout* frameControlsGrid = new Q3GridLayout( frameControlsFrame, 3, 2, 0 );
  frameControlsGrid->setSpacing(TIGHT_WIDGET_SPACING);  
  frameControlsGrid->addMultiCellWidget( rotateFlipFrame, 0,0,  0,1 );
  frameControlsGrid->addWidget( aspectRatios,     1, 0, Qt::AlignHCenter );  
  frameControlsGrid->addWidget( cropButton,       1, 1, Qt::AlignHCenter );  
  frameControlsGrid->addWidget( aspectRatioLabel, 2, 0, Qt::AlignHCenter );  
  frameControlsGrid->addWidget( cropLabel,        2, 1, Qt::AlignHCenter );    
 
  //----------  
  //Enhance Controls
  //----------    
  Q3Frame* enhanceControlsFrame = new Q3Frame( enhanceControls );  
  
  //setup params for large buttons  
  int numLargeButtons = 3;
  int curButtonIndex=0;
  ClickableLabel** largeButtons = new ClickableLabel*[numLargeButtons];
  
 
  //--------------------
  //Frame for semi-automatic enhance controls
  Q3Frame* autoEnhanceControlsFrame = new Q3Frame( enhanceControlsFrame );  
 
  //Enhance Color
  ClickableLabel* enhanceColorButton = largeButtons[curButtonIndex] = 
    new ClickableLabel( autoEnhanceControlsFrame );
  largeButtons[curButtonIndex]->setPixmap( QPixmap(QString(IMAGE_PATH)+"buttonIcons/improveColorBalance.png") );
  connect( largeButtons[curButtonIndex], SIGNAL(clicked()), SLOT(colorBalance()) );
  QToolTip::add( largeButtons[curButtonIndex], tr("Enhance color balance") );  
  curButtonIndex++;
 
  QLabel* enhanceColorLabel = new QLabel( tr("Color"), autoEnhanceControlsFrame );
  enhanceColorLabel->setFont( smallerFont );  
  
  //Enhance Contrast
  ClickableLabel* enhanceContrastButton = largeButtons[curButtonIndex] = 
    new ClickableLabel( autoEnhanceControlsFrame );
  largeButtons[curButtonIndex]->setPixmap( QPixmap(QString(IMAGE_PATH)+"buttonIcons/enhanceContrast.png") );
  connect( largeButtons[curButtonIndex], SIGNAL(clicked()), SLOT(enhanceContrast()) );
  QToolTip::add( largeButtons[curButtonIndex], tr("Enhance contrast") );  
  curButtonIndex++;
  
  QLabel* enhanceContrastLabel = new QLabel( tr("Contrast"), autoEnhanceControlsFrame );
  enhanceContrastLabel->setFont( smallerFont );  
 
  //Remove Red-Eye  
  redEyeReductionButton = largeButtons[curButtonIndex] = new ClickableLabel( autoEnhanceControlsFrame );
  redEyeReductionButton->setEnabled( false );
  
  largeButtons[curButtonIndex]->setPixmap( QPixmap( QString(IMAGE_PATH)+"buttonIcons/redEyeReduction.png" ) );
  connect( largeButtons[curButtonIndex], SIGNAL(clicked()), SLOT(removeRedeye()) );
  QToolTip::add( largeButtons[curButtonIndex], tr("Remove red-eye") );  
  curButtonIndex++;
 
  QLabel* removeRedyEyeLabel = new QLabel( tr("Red Eye"), autoEnhanceControlsFrame );
  removeRedyEyeLabel->setFont( smallerFont );  
 
  //Place semi-automatic enhance controls in grid
  Q3GridLayout* autoEnhanceControlsGrid = new Q3GridLayout( autoEnhanceControlsFrame, 2, 3, 0 );
  autoEnhanceControlsGrid->setSpacing(TIGHT_WIDGET_SPACING);  
  autoEnhanceControlsGrid->addWidget( enhanceColorButton,    0, 0, Qt::AlignHCenter );
  autoEnhanceControlsGrid->addWidget( enhanceColorLabel,     1, 0, Qt::AlignHCenter );  
 
  autoEnhanceControlsGrid->addWidget( enhanceContrastButton, 0, 1, Qt::AlignHCenter );
  autoEnhanceControlsGrid->addWidget( enhanceContrastLabel,  1, 1, Qt::AlignHCenter );  
 
  autoEnhanceControlsGrid->addWidget( redEyeReductionButton, 0, 2, Qt::AlignHCenter );
  autoEnhanceControlsGrid->addWidget( removeRedyEyeLabel,    1, 2, Qt::AlignHCenter );  
  //--------------------
  //Frame for more labor intensive enhance controls
  Q3Frame* manualEnhanceControlsFrame = new Q3Frame( enhanceControlsFrame );  
  
  //Tune Levels Button
  ClickableLabel* tuneLevelsButton = new ClickableLabel( manualEnhanceControlsFrame );
  tuneLevelsButton->setPixmap( QPixmap(QString(IMAGE_PATH)+"buttonIcons/tuneLevels.png") );
  connect( tuneLevelsButton, SIGNAL(clicked()), SLOT(tuneLevels()) );
  QToolTip::add( tuneLevelsButton, tr("Fine tune brightness, contrast, and colors") );  
  
  QLabel* tuneLevelsLabel = new QLabel( tr("Levels..."), manualEnhanceControlsFrame );
  tuneLevelsLabel->setFont( smallerFont );  
 
  //Adjust Grain Button
  ClickableLabel* adjustGrainButton = new ClickableLabel( manualEnhanceControlsFrame );
  adjustGrainButton->setPixmap( QPixmap(QString(IMAGE_PATH)+"buttonIcons/adjustGrain.png") );
  connect( adjustGrainButton, SIGNAL(clicked()), SLOT(adjustGrain()) );
  QToolTip::add( adjustGrainButton, tr("Blur or sharpen image") );  
 
  QLabel* adjustGrainLabel = new QLabel( tr("Grain..."), manualEnhanceControlsFrame );
  adjustGrainLabel->setFont( smallerFont );  
 
  //Place manual enhance controls in grid
  Q3GridLayout* manualEnhanceControlsGrid = new Q3GridLayout( manualEnhanceControlsFrame, 2, 3, 0 );
  manualEnhanceControlsGrid->setSpacing(TIGHT_WIDGET_SPACING);  
  manualEnhanceControlsGrid->addWidget( tuneLevelsButton,    0, 0, Qt::AlignHCenter );
  manualEnhanceControlsGrid->addWidget( tuneLevelsLabel,     1, 0, Qt::AlignHCenter );
  manualEnhanceControlsGrid->setColSpacing( 1, WIDGET_SPACING );
  manualEnhanceControlsGrid->addWidget( adjustGrainButton, 0, 2, Qt::AlignHCenter );
  manualEnhanceControlsGrid->addWidget( adjustGrainLabel,  1, 2, Qt::AlignHCenter );
  //--------------------
 
  //Place enhance controls in a grid
  Q3GridLayout* enhanceControlsGrid = new Q3GridLayout( enhanceControlsFrame, 4, 2, 0 );
  enhanceControlsGrid->setSpacing(WIDGET_SPACING);  
  enhanceControlsGrid->addWidget( autoEnhanceControlsFrame,   0, 0, Qt::AlignHCenter );
  enhanceControlsGrid->addWidget( manualEnhanceControlsFrame, 1, 0, Qt::AlignHCenter );
  enhanceControlsGrid->setRowStretch( 0, 1 );
  enhanceControlsGrid->setRowStretch( 3, 1 );
  
  //----------  
  //Effects Controls
  //----------  
  Q3Frame* manipulateControlsFrame = new Q3Frame( manipulateControls, "manipulateControlsFrame" );
  //--  
  //Effects
  effectsList = new QComboBox( manipulateControlsFrame );
  effectsList->setFont( smallerFont );  
  connect( effectsList, SIGNAL(activated(int)), this, SLOT(selectEffect()) );
 
  int i;
  for(i=0; i<NUM_MANIPULATIONS; i++)
  {
    switch(i)
    {
      case BW_EFFECT:          effectsList->insertItem( tr("B + W") );       break;
      case SEPIA_EFFECT:       effectsList->insertItem( tr("Sepia") );       break;
      case INVERT_EFFECT:      effectsList->insertItem( tr("Invert") );      break;
      case EMBOSS_EFFECT:      effectsList->insertItem( tr("Emboss") );      break;
      case MOSAIC_EFFECT:      effectsList->insertItem( tr("Mosaic") );       break;
      case PAINTING_EFFECT:    effectsList->insertItem( tr("Painting") );    break;
      case POINTILLISM_EFFECT: effectsList->insertItem( tr("Pointillism") ); break;
    }
  }
 
  //Apply effect button
  applyEffectButton = new QPushButton( tr("Apply"), manipulateControlsFrame );
  applyEffectButton->setFont( smallerFont );  
  connect( applyEffectButton, SIGNAL(clicked()), SLOT(applyEffect()) );   
  
  //preview of seleted effect
  effectPreview = new QLabel( manipulateControlsFrame );
 
  //Place effects controls in a grid
  Q3GridLayout* manipulateControlsGrid = new Q3GridLayout( manipulateControlsFrame, 2, 2, 0 );
  manipulateControlsGrid->setSpacing(TIGHT_WIDGET_SPACING);  
  manipulateControlsGrid->addWidget( effectsList, 0, 0 );
  manipulateControlsGrid->addWidget( applyEffectButton, 1, 0, Qt::AlignHCenter );  
  manipulateControlsGrid->addMultiCellWidget( effectPreview, 0,1, 1,1, Qt::AlignHCenter );  
 
  //make sure preview image always requires EFFECT_PREVIEW_WIDTH width so contorls don't
  //move around when rotating photos
  manipulateControlsGrid->setColSpacing(1, 85 );
}

References adjustGrain(), applyEffect(), applyEffectButton, aspectRatios, aspectRatioValues, BW_EFFECT, colorBalance(), correctTiltButton, crop(), cropButton, displayResolutionIndex, effectPreview, effectsList, EMBOSS_EFFECT, enhanceContrast(), finishCorrectTilt(), flipHorizontal(), flipVertical(), handleAspectRatioChanged(), handleSelectionChanged(), IMAGE_PATH, INVERT_EFFECT, layout, maxDimensions, MOSAIC_EFFECT, nextButton, NUM_MANIPULATIONS, PAINTING_EFFECT, photo, POINTILLISM_EFFECT, previousButton, redEyeReductionButton, removeRedeye(), rotateLeft(), rotateRight(), rotateSelection(), screenResolutionChanged(), selectAspectRatio(), selectEffect(), selectionInterface, SEPIA_EFFECT, ClickableLabel::setEnabled(), ClickableLabel::setPixmap(), showNextPhoto(), showPrevPhoto(), startCorrectTilt(), TIGHT_WIDGET_SPACING, tuneLevels(), and WIDGET_SPACING.

◆ ~EditingInterface()

EditingInterface::~EditingInterface ( )

Definition at line 433 of file editingInterface.cpp.

433{ }

Member Function Documentation

◆ adjustGrain

void EditingInterface::adjustGrain ( )

privateslot

Opens image grain editor.

Definition at line 753 of file editingInterface.cpp.

{
  //load photo in grain editor
  //if changes took place update image
  GrainEditor editor( photo->getImageFilename(), this);
  if( editor.exec() ) 
  { 
    //set busy cursor
    qApp->setOverrideCursor( QCursor(Qt::WaitCursor));
    qApp->processEvents();
    
    //disable user input
    layout->getWindow()->getStatus()->grabInput();
 
    //update image    
    applyImageUpdate( editor.getModifiedImage(), false ); 
    
    //enable user input
    layout->getWindow()->getStatus()->releaseInput();
 
    //remove busy cursor
    qApp->restoreOverrideCursor();
    qApp->processEvents();
  }
}

References applyImageUpdate(), Photo::getImageFilename(), GrainEditor::getModifiedImage(), Window::getStatus(), LayoutWidget::getWindow(), StatusWidget::grabInput(), layout, photo, and StatusWidget::releaseInput().

Referenced by EditingInterface().

◆ applyEffect [1/2]

void EditingInterface::applyEffect ( )

privateslot

Apply selected effect.

Definition at line 793 of file editingInterface.cpp.

{  
  //--------------------------------
  //Get any manipulation options if needed
  ManipulationOptions* options = NULL;
  if( effectsList->currentItem() == MOSAIC_EFFECT )   
  {
    MosaicOptionsDialog optionsDialog(this);
    //user accepted so get selected options
    if( optionsDialog.exec() ) 
    { 
      //constructing the tiles list can unfortunately be quite slow so show a preparing tiles message
      //and busy icon while getting the options chosen
      layout->getWindow()->getStatus()->showProgressBar( QString(tr("Preparing Tiles")), 100 );
      qApp->setOverrideCursor( QCursor(Qt::WaitCursor));
      qApp->processEvents();       
      options = optionsDialog.getOptions(); 
      qApp->restoreOverrideCursor();
    }
    //user hit cancel so bail
    else 
    { return; }
  }
  else
  { options = new ManipulationOptions( layout->getWindow()->getStatus() ); }
  //--------------------------------
  //Disable user input
  layout->getWindow()->getStatus()->grabInput();
  applyEffectButton->setEnabled(false);
  qApp->setOverrideCursor( QCursor(Qt::WaitCursor));
  qApp->processEvents();
  //--------------------------------
  //Apply effect
  QImage* editedImage = applyEffect( photo->getImageFilename(), options );
  applyImageUpdate( editedImage, false );
  delete options; options = NULL;
  //--------------------------------
  //Remove status bar if present and reenable user input
  layout->getWindow()->getStatus()->setStatus( "" );
  layout->getWindow()->getStatus()->releaseInput();
  applyEffectButton->setEnabled(true);
  qApp->restoreOverrideCursor();
  qApp->processEvents();
  //--------------------------------
} 

References applyEffect(), applyEffectButton, applyImageUpdate(), editedImage, effectsList, Photo::getImageFilename(), MosaicOptionsDialog::getOptions(), Window::getStatus(), LayoutWidget::getWindow(), StatusWidget::grabInput(), layout, MOSAIC_EFFECT, photo, StatusWidget::releaseInput(), StatusWidget::setStatus(), and StatusWidget::showProgressBar().

Referenced by applyEffect(), EditingInterface(), and selectEffect().

◆ applyEffect() [2/2]

QImage * EditingInterface::applyEffect	(	QString	filename,
		ManipulationOptions *	options = NULL )

private

utlity function for apply effect and preview effect slots

Definition at line 839 of file editingInterface.cpp.

{
  //apply effect
  QImage* effectedImage = NULL;
  switch( effectsList->currentItem() )
  {
    case BW_EFFECT:          effectedImage = blackWhiteEffect(  filename, options ); break;
    case SEPIA_EFFECT:       effectedImage = sepiaEffect(       filename, options ); break;
    case INVERT_EFFECT:      effectedImage = invertEffect(      filename, options ); break;
    case EMBOSS_EFFECT:      effectedImage = embossEffect(      filename, options ); break;
    case PAINTING_EFFECT:    effectedImage = oilPaintingEffect( filename, options ); break;
    case POINTILLISM_EFFECT: effectedImage = pointillismEffect( filename, options ); break;
    case MOSAIC_EFFECT:      effectedImage = mosaicEffect(      filename, (MosaicOptions*) options ); break;
  }
 
  //return effected image
  return effectedImage;
}

References blackWhiteEffect(), BW_EFFECT, effectsList, EMBOSS_EFFECT, embossEffect(), INVERT_EFFECT, invertEffect(), MOSAIC_EFFECT, mosaicEffect(), oilPaintingEffect(), PAINTING_EFFECT, POINTILLISM_EFFECT, pointillismEffect(), SEPIA_EFFECT, and sepiaEffect().

◆ applyImageUpdate()

void EditingInterface::applyImageUpdate	(	QImage *	editedImage,
		bool	resetSelection )

private

Applies update to image.

Definition at line 858 of file editingInterface.cpp.

{  
  //skip apply step if pointer is null. this usually means
  //no modifications were made (for example: no red eyes were detected)
  if(editedImage == NULL) 
  { 
    //sometimes the user instructs the program to modify an image in a way
    //where no real changes are actually necessary. case in point, red eye reduction
    //on a region where there is no red stuff at all! in order to be consistant, if
    //the user is expecting the selection to be reset then always reset it! this
    //normally occurs below when resetting the photo but we'll do it here 
    //since resetting the photo will not take place
    if(resetSelection) 
    { 
      selectionInterface->selectNone(); 
    }
    
    return; 
  }
  
  //construct edited image path
  QString editedImagePath = ((Window*)qApp->mainWidget())->getTitle()->getAlbum()->getTmpDir() + "/editedImage.jpg";
 
  //save edited image to temporary location
  //TODO: EXIF information is lost at this point, Qt does not support
  //storing exif information, but perhaps a 2nd pass can be made on the file
  //where exif info is added using libjpeg functions?
  editedImage->save( editedImagePath, "JPEG", 95 );
  delete editedImage;
  editedImage = NULL;
    
  //apply changes to photo
  photo->setImage( editedImagePath );
  
  //Reload photo view
  selectionInterface->setPhoto( editedImagePath, resetSelection );  
 
  //If we're resetting the selection (due to cropping), reset the 
  //selection rotated bit as well
  if( resetSelection ) { selectionRotated = false; }
  
  //update image dimension variables
  getImageSize( photo->getImageFilename(), imageWidth, imageHeight );  
 
  //get display size photo dimensions
  selectionInterface->getDisplaySize( displayWidth, displayHeight );
 
  //update effect preview
  scaleImage( photo->getImageFilename(), effectPreviewImageFilename, EFFECT_PREVIEW_WIDTH, EFFECT_PREVIEW_HEIGHT );
  selectEffect();
  
  //emit modified signal
  emit photoModified();
}

References displayHeight, displayWidth, editedImage, EFFECT_PREVIEW_HEIGHT, EFFECT_PREVIEW_WIDTH, effectPreviewImageFilename, SelectionInterface::getDisplaySize(), Photo::getImageFilename(), getImageSize(), imageHeight, imageWidth, photo, photoModified(), scaleImage(), selectEffect(), selectionInterface, selectionRotated, SelectionInterface::selectNone(), Photo::setImage(), and SelectionInterface::setPhoto().

Referenced by adjustGrain(), applyEffect(), colorBalance(), crop(), enhanceContrast(), finishCorrectTilt(), removeRedeye(), and tuneLevels().

◆ colorBalance

void EditingInterface::colorBalance ( )

privateslot

Improve color balance.

Definition at line 677 of file editingInterface.cpp.

{
  //set busy cursor
  qApp->setOverrideCursor( QCursor(Qt::WaitCursor));
  qApp->processEvents();
 
  //disable user input
  layout->getWindow()->getStatus()->grabInput();
 
  //improve color balance
  applyImageUpdate( improveColorBalance( photo->getImageFilename(),
                                         layout->getWindow()->getStatus() ),
                    false );
 
  //enable user input
  layout->getWindow()->getStatus()->releaseInput();
 
  //remove busy cursor
  qApp->restoreOverrideCursor();
  qApp->processEvents();
}

References applyImageUpdate(), Photo::getImageFilename(), Window::getStatus(), LayoutWidget::getWindow(), StatusWidget::grabInput(), improveColorBalance(), layout, photo, and StatusWidget::releaseInput().

Referenced by EditingInterface().

◆ crop

void EditingInterface::crop ( )

privateslot

Cropped image.

Definition at line 631 of file editingInterface.cpp.

{
  //find selection, if empty bail!
  QPoint topLeft, bottomRight;
  if (!findSelection(topLeft, bottomRight) )
    return;
 
  //set busy cursor
  qApp->setOverrideCursor( QCursor(Qt::WaitCursor));
 
  //disable user input
  layout->getWindow()->getStatus()->grabInput();
 
  //crop image
  applyImageUpdate( cropImage( photo->getImageFilename(), topLeft, bottomRight ),
                    true );
 
  //enable user input
  layout->getWindow()->getStatus()->releaseInput();
 
  //remove busy cursor
  qApp->restoreOverrideCursor();
}

References applyImageUpdate(), bottomRight, cropImage(), findSelection(), Photo::getImageFilename(), Window::getStatus(), LayoutWidget::getWindow(), StatusWidget::grabInput(), layout, photo, StatusWidget::releaseInput(), and topLeft.

Referenced by EditingInterface().

◆ currentPhotoRevertable()

bool EditingInterface::currentPhotoRevertable ( )

Definition at line 1000 of file editingInterface.cpp.

{
  if(photo == NULL) 
    return false;
  else
    return photo->revertPossible();
}

References photo, and Photo::revertPossible().

Referenced by LayoutWidget::photoStateChangedEvent(), and revertCurrentPhoto().

◆ enhanceContrast

void EditingInterface::enhanceContrast ( )

privateslot

Enhance image contrast.

Definition at line 655 of file editingInterface.cpp.

{
  //set busy cursor
  qApp->setOverrideCursor( QCursor(Qt::WaitCursor));
  qApp->processEvents();
 
  //disable user input
  layout->getWindow()->getStatus()->grabInput();
 
  //enhance image
  applyImageUpdate( enhanceImageContrast( photo->getImageFilename(),
                                          layout->getWindow()->getStatus() ),
                    false );
 
  //enable user input
  layout->getWindow()->getStatus()->releaseInput();
 
  //remove busy cursor
  qApp->restoreOverrideCursor();
  qApp->processEvents();
}

References applyImageUpdate(), enhanceImageContrast(), Photo::getImageFilename(), Window::getStatus(), LayoutWidget::getWindow(), StatusWidget::grabInput(), layout, photo, and StatusWidget::releaseInput().

Referenced by EditingInterface().

◆ findSelection()

bool EditingInterface::findSelection	(	QPoint &	topLeft,
		QPoint &	bottomRight )

private

Finds the selected region of the image.

Definition at line 919 of file editingInterface.cpp.

{
  //get raw selection in display coordinates
  selectionInterface->getSelection(topLeft, bottomRight);
 
  //if range is empty then retrun false
  if(topLeft.x() >= bottomRight.x() ||
     topLeft.y() >= bottomRight.y())
    return false;
  
  //return success
  return true;
}

References bottomRight, SelectionInterface::getSelection(), selectionInterface, and topLeft.

Referenced by crop(), handleSelectionChanged(), and removeRedeye().

◆ finishCorrectTilt

void EditingInterface::finishCorrectTilt	(	QPoint	p1,
		QPoint	p2 )

privateslot

Finish correcting and image's tilt.

Definition at line 1220 of file editingInterface.cpp.

{
  //if either point is invalid ignore action
  if( p1.x() == -1 || p2.x() == -1 )
  {
    //reenable tilt button
    correctTiltButton->setEnabled( true );
    return;
  }
  
  //set busy cursor
  qApp->setOverrideCursor( QCursor(Qt::WaitCursor));
  
  //disable user input
  layout->getWindow()->getStatus()->grabInput();
  
  //rotate image by determining correct angle from two points
  QImage* rotatedImage = correctImageTilt( photo->getImageFilename(), p1, p2,
                                           layout->getWindow()->getStatus() );
  applyImageUpdate( rotatedImage, true );
  
  //reenable tilt button
  correctTiltButton->setEnabled( true );
 
  //enable user input
  layout->getWindow()->getStatus()->releaseInput();
 
  //remove busy cursor
  qApp->restoreOverrideCursor();
}

References applyImageUpdate(), correctImageTilt(), correctTiltButton, Photo::getImageFilename(), Window::getStatus(), LayoutWidget::getWindow(), StatusWidget::grabInput(), layout, photo, and StatusWidget::releaseInput().

Referenced by EditingInterface().

◆ flipHorizontal

void EditingInterface::flipHorizontal ( )

privateslot

Flip image horizontally.

Definition at line 562 of file editingInterface.cpp.

{
  rotateFlip( FLIP_H );
}

References FLIP_H, and rotateFlip().

Referenced by EditingInterface(), and keyPressEvent().

◆ flipVertical

void EditingInterface::flipVertical ( )

privateslot

Flip image vertically.

Definition at line 567 of file editingInterface.cpp.

{
  rotateFlip( FLIP_V );
}

References FLIP_V, and rotateFlip().

Referenced by EditingInterface(), and keyPressEvent().

◆ getPhoto()

Photo * EditingInterface::getPhoto ( )

Returns a pointer to the currently selected photo.

Definition at line 435 of file editingInterface.cpp.

435{ return photo; }

References photo.

Referenced by LayoutWidget::tabChanged().

◆ handleAspectRatioChanged

void EditingInterface::handleAspectRatioChanged ( )

slot

Definition at line 943 of file editingInterface.cpp.

{
  //change aspect ratio combo box to custom
  aspectRatios->setCurrentItem(0);  
}

References aspectRatios.

Referenced by EditingInterface().

◆ handleSelectionChanged

void EditingInterface::handleSelectionChanged ( )

slot

Definition at line 933 of file editingInterface.cpp.

{
  //crop button is enabled only when a portion of the image is selected
  QPoint topLeft, bottomRight;
  bool selectionPresent = findSelection(topLeft,bottomRight);     
 
  cropButton->setEnabled( selectionPresent );
  redEyeReductionButton->setEnabled( selectionPresent );  
}

References bottomRight, cropButton, findSelection(), redEyeReductionButton, ClickableLabel::setEnabled(), and topLeft.

Referenced by EditingInterface().

◆ keyPressEvent()

void EditingInterface::keyPressEvent ( QKeyEvent * e )

protected

Definition at line 957 of file editingInterface.cpp.

{
  //next handle additional keys
  switch( e->key() )
  {
    //apply changes and exit
    case Qt::Key_Escape:
      returnAction();
      break;
    case Qt::Key_PageUp:
      showPrevPhoto();
      break;
    case Qt::Key_PageDown:
      showNextPhoto();
      break;
    case Qt::Key_Home:
      showFirstPhoto();
      break;
    case Qt::Key_End:
      showLastPhoto();
      break;
    case Qt::Key_R:
      if(e->state() & Qt::ControlModifier)
        rotateRight();
      break;
    case Qt::Key_L:
      if(e->state() & Qt::ControlModifier)
        rotateLeft();
      break;
    case Qt::Key_F:
      if(e->state() & Qt::ControlModifier)
      {
        if( e->state() & Qt::AltModifier )
          flipVertical();
        else
          flipHorizontal();
      }
      break;
    default:
      e->ignore();
  }
}

References flipHorizontal(), flipVertical(), returnAction(), rotateLeft(), rotateRight(), showFirstPhoto(), showLastPhoto(), showNextPhoto(), and showPrevPhoto().

◆ photoModified

void EditingInterface::photoModified ( )

signal

Referenced by applyImageUpdate(), revertCurrentPhoto(), rotateFlip(), and showNextPrevFirstLastPhoto().

◆ removeRedeye

void EditingInterface::removeRedeye ( )

privateslot

Applies redeye removal.

Definition at line 699 of file editingInterface.cpp.

{
  //find selection, if empty bail!
  QPoint topLeft, bottomRight;
  if (!findSelection(topLeft, bottomRight) )
    return;
 
  //set busy cursor
  qApp->setOverrideCursor( QCursor(Qt::WaitCursor));
  qApp->processEvents();
  
  //disable user input
  layout->getWindow()->getStatus()->grabInput();
 
  //remove redeye image
  applyImageUpdate( removeRedeyeRegions( photo->getImageFilename(), 
                                         topLeft, bottomRight,
                                         layout->getWindow()->getStatus() ),
                    true );
 
  //enable user input
  layout->getWindow()->getStatus()->releaseInput();
 
  //remove busy cursor
  qApp->restoreOverrideCursor();
  qApp->processEvents();
}

References applyImageUpdate(), bottomRight, findSelection(), Photo::getImageFilename(), Window::getStatus(), LayoutWidget::getWindow(), StatusWidget::grabInput(), layout, photo, StatusWidget::releaseInput(), removeRedeyeRegions(), and topLeft.

Referenced by EditingInterface().

◆ returnAction

void EditingInterface::returnAction ( )

privateslot

Exit editing interface.

Definition at line 913 of file editingInterface.cpp.

{
  //exit edit mode
  layout->organize();
}

References layout, and LayoutWidget::organize().

Referenced by keyPressEvent().

◆ revertCurrentPhoto()

void EditingInterface::revertCurrentPhoto ( )

reverts current photo and updates display

Revert photo

Definition at line 1008 of file editingInterface.cpp.

{
  //if current photo not revertable immediately bail
  if( ! currentPhotoRevertable() ) return;
  
  //set busy cursor
  qApp->setOverrideCursor( QCursor(Qt::WaitCursor));
  
  //disable user input
  layout->getWindow()->getStatus()->grabInput();
 
  //get current and reverted image sizes and compare to see if size has changed.
  //if so reset selected region
  int origWidth, origHeight;
  getImageSize( photo->originalImageFilename(), origWidth, origHeight );  
  bool resetSelection = (origWidth != imageWidth) || (origHeight != imageHeight);
  
  photo->revertPhoto();
 
  //Reload photo view
  selectionInterface->setPhoto( photo->getImageFilename(), resetSelection );  
  
  //update image dimension variables
  getImageSize( photo->getImageFilename(), imageWidth, imageHeight );  
  
  //get display size photo dimensions
  selectionInterface->getDisplaySize( displayWidth, displayHeight );
  
  //update effect preview
  scaleImage( photo->getImageFilename(), effectPreviewImageFilename, EFFECT_PREVIEW_WIDTH, EFFECT_PREVIEW_HEIGHT );
  selectEffect();  
  
  //emit modified signal
  emit photoModified();
 
  //enable user input
  layout->getWindow()->getStatus()->releaseInput();
 
  //remove busy cursor
  qApp->restoreOverrideCursor();
}

References currentPhotoRevertable(), displayHeight, displayWidth, EFFECT_PREVIEW_HEIGHT, EFFECT_PREVIEW_WIDTH, effectPreviewImageFilename, SelectionInterface::getDisplaySize(), Photo::getImageFilename(), getImageSize(), Window::getStatus(), LayoutWidget::getWindow(), StatusWidget::grabInput(), imageHeight, imageWidth, layout, Photo::originalImageFilename(), photo, photoModified(), StatusWidget::releaseInput(), Photo::revertPhoto(), scaleImage(), selectEffect(), selectionInterface, and SelectionInterface::setPhoto().

Referenced by LayoutWidget::revertPhotos().

◆ rotateFlip()

void EditingInterface::rotateFlip ( TRANSFORM_CODE rotationFlipType )

private

Utility method for rotation + flip slots.

Definition at line 572 of file editingInterface.cpp.

{
  //set busy pointer
  qApp->setOverrideCursor( QCursor(Qt::WaitCursor));
  qApp->processEvents();
  
  //disable user input
  layout->getWindow()->getStatus()->grabInput();
  
  //rotate image, bail if rotation fails
  QString editedImagePath = ((Window*)qApp->mainWidget())->getTitle()->getAlbum()->getTmpDir() + "/editedImage.jpg";
  transformImage( photo->getImageFilename(), editedImagePath, rotationFlipType );
 
  //apply changes to photo
  photo->setImage( editedImagePath );
  
  //Reload photo view
  bool aspectRatioChanged = ( rotationFlipType == ROTATE_90 || rotationFlipType == ROTATE_270 );  
  selectionInterface->setPhoto( editedImagePath, aspectRatioChanged );  
  
  //update image dimension variables
  getImageSize( photo->getImageFilename(), imageWidth, imageHeight );  
  
  //get display size photo dimensions
  selectionInterface->getDisplaySize( displayWidth, displayHeight );
  
  //reapply selected aspect ratio selection if aspect ratio changed
  if( aspectRatioChanged )
  {
    //reset selectionRotated bool to false
    selectionRotated = false;
    selectAspectRatio();      
  }
  
  //update effect preview
  scaleImage( photo->getImageFilename(), effectPreviewImageFilename, EFFECT_PREVIEW_WIDTH, EFFECT_PREVIEW_HEIGHT );
  selectEffect();
  
  //emit modified signal
  emit photoModified();
  
  //enable user input
  layout->getWindow()->getStatus()->releaseInput();
 
  //remove busy cursor
  qApp->restoreOverrideCursor();
  qApp->processEvents();
}

References displayHeight, displayWidth, EFFECT_PREVIEW_HEIGHT, EFFECT_PREVIEW_WIDTH, effectPreviewImageFilename, SelectionInterface::getDisplaySize(), Photo::getImageFilename(), getImageSize(), Window::getStatus(), LayoutWidget::getWindow(), StatusWidget::grabInput(), imageHeight, imageWidth, layout, photo, photoModified(), StatusWidget::releaseInput(), ROTATE_270, ROTATE_90, scaleImage(), selectAspectRatio(), selectEffect(), selectionInterface, selectionRotated, Photo::setImage(), SelectionInterface::setPhoto(), and transformImage().

Referenced by flipHorizontal(), flipVertical(), rotateLeft(), and rotateRight().

◆ rotateLeft

void EditingInterface::rotateLeft ( )

privateslot

Rotate image left 90 degrees.

Definition at line 557 of file editingInterface.cpp.

{
  rotateFlip( ROTATE_270 );
}

References ROTATE_270, and rotateFlip().

Referenced by EditingInterface(), and keyPressEvent().

◆ rotateRight

void EditingInterface::rotateRight ( )

privateslot

Rotate image right 90 degrees.

Definition at line 552 of file editingInterface.cpp.

{
  rotateFlip( ROTATE_90 );
}

References ROTATE_90, and rotateFlip().

Referenced by EditingInterface(), and keyPressEvent().

◆ rotateSelection

void EditingInterface::rotateSelection ( )

privateslot

Rotate current selection.

Definition at line 1057 of file editingInterface.cpp.

{
  //invert rotate bool
  selectionRotated = !selectionRotated;
  
  //rotate custom selection in place, scale/shift if necessary to keep on image
  if(aspectRatios->currentItem() == 0)
  {
    //get cur selection
    QPoint curTopLeft, curBottomRight;
    selectionInterface->getSelection(curTopLeft, curBottomRight); 
 
    //find center
    QPoint selectionCenter = QPoint( ( curTopLeft.x() + curBottomRight.x() ) / 2,
                                     ( curTopLeft.y() + curBottomRight.y() ) / 2 );    
 
    //scale rotated width/height to fit image
    int newWidth = curBottomRight.y() - curTopLeft.y() + 1;
    int newHeight =curBottomRight.x() - curTopLeft.x() + 1;
    calcScaledImageDimensions( newWidth, newHeight,
                               imageWidth, imageHeight,
                               newWidth, newHeight );
 
    //center new selection over old selection
    QPoint topLeft = QPoint( selectionCenter.x() - newWidth/2,
                             selectionCenter.y() - newHeight/2 );
    QPoint bottomRight = QPoint( topLeft.x() + newWidth - 1,
                                 topLeft.y() + newHeight - 1 );
 
    //shift selection area to not go outside image boundary
    if(topLeft.x() < 0)
    {
      bottomRight.setX( bottomRight.x() - topLeft.x() );
      topLeft.setX( 0 );
    }
 
    if(topLeft.y() < 0)
    {
      bottomRight.setY( bottomRight.y() - topLeft.y() );
      topLeft.setY( 0 );
    }
    
    if(bottomRight.x() >= imageWidth )
    {
      topLeft.setX( topLeft.x() - ( bottomRight.x() - imageWidth + 1 ) );
      bottomRight.setX( imageWidth - 1 );
    }
 
    if(bottomRight.y() >= imageHeight )
    {
      topLeft.setY( topLeft.y() - ( bottomRight.y() - imageHeight + 1 ) );
      bottomRight.setY( imageHeight - 1 );
    }
    
    //select new region
    selectionInterface->setSelection(topLeft, bottomRight);    
  }
  //else call selectAspectRatio passing true that we're
  //using the rotated version of the current aspect ratio
  else
  { 
    selectAspectRatio(); 
  }
}

References aspectRatios, bottomRight, calcScaledImageDimensions(), SelectionInterface::getSelection(), imageHeight, imageWidth, selectAspectRatio(), selectionInterface, selectionRotated, SelectionInterface::setSelection(), and topLeft.

Referenced by EditingInterface().

◆ screenResolutionChanged

void EditingInterface::screenResolutionChanged ( )

privateslot

Update recorded screen resolution and selection if necessary.

Definition at line 621 of file editingInterface.cpp.

{
  //reset display resolution
  aspectRatioValues[displayResolutionIndex] = qApp->desktop()->screenGeometry().size();
 
  //if user is currently constraining the current selection then reset to fit new display resolution
  if(aspectRatios->currentItem() == displayResolutionIndex )
  { selectAspectRatio(); }
}

References aspectRatios, aspectRatioValues, displayResolutionIndex, and selectAspectRatio().

Referenced by EditingInterface().

◆ selectAll()

void EditingInterface::selectAll	(	QPoint &	topLeft,
		QPoint &	bottomRight )

private

Return coordinates that select entire image.

Definition at line 949 of file editingInterface.cpp.

{
  topLeft.setX(0); 
  topLeft.setY(0);
  bottomRight.setX(imageWidth - 1); 
  bottomRight.setY(imageHeight - 1);     
}

References bottomRight, imageHeight, imageWidth, and topLeft.

◆ selectAspectRatio

void EditingInterface::selectAspectRatio ( )

privateslot

Aspect ratio selection changed.

Definition at line 1122 of file editingInterface.cpp.

{
  //if user selected "custom" don't modify current selection
  if( aspectRatios->currentItem() == 0 ) return;
  
  //get default aspect ratio
  QSize aspectRatio = aspectRatioValues[ aspectRatios->currentItem() ];  
 
  //automatically rotate default if current photo is taller than wide
  if( imageHeight > imageWidth )
  { aspectRatio = QSize( aspectRatio.height(), aspectRatio.width() ); }
  
  //exchange aspect ratio dimensions if we're in rotated selection mode
  if( selectionRotated )
  { aspectRatio = QSize( aspectRatio.height(), aspectRatio.width() ); }
    
  //determine selected width and height;
  int selectedWidth = 0; 
  int selectedHeight = 0;
  
  //display resolution, match exactly or scale down
  if(aspectRatios->currentItem() == displayResolutionIndex)
  {    
    //select region less than or equal to display resolution while maintaining aspect ratio
    selectedWidth = aspectRatio.width();
    selectedHeight = aspectRatio.height();
    calcScaledImageDimensions( selectedWidth, selectedHeight,
                               imageWidth, imageHeight,
                               selectedWidth, selectedHeight );
  }
  //else use aspect ratio directly as a ratio
  else
  {  
    //select region using same aspect ratio
    selectedWidth = imageWidth;
    selectedHeight = (int) (((double) (imageWidth * aspectRatio.height()) ) / aspectRatio.width() );
    calcScaledImageDimensions( selectedWidth, selectedHeight,
                               imageWidth, imageHeight,
                               selectedWidth, selectedHeight );
    
  }
  
  //get current selection boundary
  QPoint curTopLeft, curBottomRight;
  selectionInterface->getSelection( curTopLeft, curBottomRight );
  
  //get current selection center
  QPoint curCenter;
  curCenter.setX( (curTopLeft.x() + curBottomRight.x()) / 2 );
  curCenter.setY( (curTopLeft.y() + curBottomRight.y()) / 2 );
 
  //if center is off image (no previous selection) then
  //fix center to center of image
  if( curCenter.x() < 0 || curCenter.y() < 0 )
  {
    curCenter.setX( imageWidth/2 );
    curCenter.setY( imageHeight/2 );
  }
  
  //attempt to center new selection overold selection, only
  //offset if necessary
  QPoint newTopLeft, newBottomRight;
 
  newTopLeft.setX( curCenter.x() - selectedWidth/2 );
  newTopLeft.setY( curCenter.y() - selectedHeight/2 );
 
  //push right/down if necessary
  if( newTopLeft.x() < 0 ) newTopLeft.setX( 0 );
  if( newTopLeft.y() < 0 ) newTopLeft.setY( 0 );
  
  //push left/up if necessary
  newBottomRight.setX( newTopLeft.x() + selectedWidth - 1 );
  if( newBottomRight.x() >= imageWidth )
  {
    newBottomRight.setX( imageWidth-1 );
    newTopLeft.setX( newBottomRight.x() - selectedWidth + 1 );
  }
  
  newBottomRight.setY( newTopLeft.y() + selectedHeight - 1 );
  if( newBottomRight.y() >= imageHeight )
  {
    newBottomRight.setY( imageHeight-1 );
    newTopLeft.setY( newBottomRight.y() - selectedHeight + 1 );
  }
 
  //select region
  selectionInterface->setSelection(newTopLeft, newBottomRight,
                                   maxDimensions[aspectRatios->currentItem()] );    
} 

References aspectRatios, aspectRatioValues, calcScaledImageDimensions(), displayResolutionIndex, SelectionInterface::getSelection(), imageHeight, imageWidth, maxDimensions, selectionInterface, selectionRotated, and SelectionInterface::setSelection().

Referenced by EditingInterface(), rotateFlip(), rotateSelection(), screenResolutionChanged(), and showNextPrevFirstLastPhoto().

◆ selectEffect

void EditingInterface::selectEffect ( )

privateslot

Effect seletion changed.

Definition at line 779 of file editingInterface.cpp.

{  
  //apply effect on preview image
  QImage* editedImage = applyEffect( effectPreviewImageFilename );
  
  //bail if generated preview image failed
  if( editedImage == NULL ) return;
  
  //refresh displayed preview image
  effectPreview->setPixmap( QPixmap(*editedImage) );
  delete editedImage;
  editedImage = NULL;  
}

References applyEffect(), editedImage, effectPreview, and effectPreviewImageFilename.

Referenced by applyImageUpdate(), EditingInterface(), revertCurrentPhoto(), rotateFlip(), setPhoto(), and showNextPrevFirstLastPhoto().

◆ setFocus

void EditingInterface::setFocus ( )

slot

Definition at line 1051 of file editingInterface.cpp.

{
  //always pass off focus even to selection interface so it can get key strokes
  selectionInterface->setFocus();
}

References selectionInterface.

Referenced by LayoutWidget::tabChanged().

◆ setPhoto()

void EditingInterface::setPhoto	(	Subalbum *	collection,
		Photo *	photo )

Sets the photo pointer and constructs scaled qimage's for painting.

Definition at line 437 of file editingInterface.cpp.

{
  //store photo and collection object handles
  this->collection = collection;
  this->photo = photo;
 
  //update visibility of prev and next buttons
  previousButton->setInvisible( photo->getPrev() == NULL );
  nextButton->setInvisible( photo->getNext() == NULL );
  
  //reset combo menu's back to first entries
  aspectRatios->setCurrentItem(0);
  effectsList->setCurrentItem(0);
 
  //reset selectionRotated bool to false
  selectionRotated = false;
  
  //update view of photo
  selectionInterface->setPhoto( photo->getImageFilename() );  
 
  //created effect preview image  
  effectPreviewImageFilename = ((Window*)qApp->mainWidget())->getTitle()->getAlbum()->getTmpDir() + 
                               "/effectPreviewImage.jpg";
  scaleImage( photo->getImageFilename(), effectPreviewImageFilename, EFFECT_PREVIEW_WIDTH, EFFECT_PREVIEW_HEIGHT );
  selectEffect();
  
  //get full size photo dimensions
  getImageSize( photo->getImageFilename(), imageWidth, imageHeight );
  
  //get display size photo dimensions
  selectionInterface->getDisplaySize( displayWidth, displayHeight );
 
  //disable the crop and reset buttons
  cropButton->setEnabled( false );
  redEyeReductionButton->setEnabled( false );  
}

References aspectRatios, collection, cropButton, displayHeight, displayWidth, EFFECT_PREVIEW_HEIGHT, EFFECT_PREVIEW_WIDTH, effectPreviewImageFilename, effectsList, SelectionInterface::getDisplaySize(), Photo::getImageFilename(), getImageSize(), Photo::getNext(), Photo::getPrev(), imageHeight, imageWidth, nextButton, photo, previousButton, redEyeReductionButton, scaleImage(), selectEffect(), selectionInterface, selectionRotated, ClickableLabel::setEnabled(), ClickableLabel::setInvisible(), and SelectionInterface::setPhoto().

Referenced by LayoutWidget::tabChanged().

◆ showFirstPhoto

void EditingInterface::showFirstPhoto ( )

privateslot

Show first photo.

Definition at line 492 of file editingInterface.cpp.

{ 
  Photo* firstPhoto = collection->getFirst();
 
  if(firstPhoto != photo)
  { showNextPrevFirstLastPhoto( firstPhoto ); }
}

References collection, Subalbum::getFirst(), photo, and showNextPrevFirstLastPhoto().

Referenced by keyPressEvent().

◆ showLastPhoto

void EditingInterface::showLastPhoto ( )

privateslot

Show last photo.

Definition at line 500 of file editingInterface.cpp.

{ 
  Photo* lastPhoto = collection->getLast();
  
  if(lastPhoto != photo)
  { showNextPrevFirstLastPhoto( lastPhoto ); }
}

References collection, Subalbum::getLast(), photo, and showNextPrevFirstLastPhoto().

Referenced by keyPressEvent().

◆ showNextPhoto

void EditingInterface::showNextPhoto ( )

privateslot

Show next photo.

Definition at line 483 of file editingInterface.cpp.

{ 
  Photo* nextPhoto = photo->getNext();
 
  if( nextPhoto != NULL &&
      nextPhoto != photo )
  { showNextPrevFirstLastPhoto( nextPhoto ); }
}  

References Photo::getNext(), photo, and showNextPrevFirstLastPhoto().

Referenced by EditingInterface(), and keyPressEvent().

◆ showNextPrevFirstLastPhoto()

void EditingInterface::showNextPrevFirstLastPhoto ( Photo * newPhoto )

private

Utility method for show prev/next photos.

Definition at line 508 of file editingInterface.cpp.

{  
  //set busy pointer
  qApp->setOverrideCursor( QCursor(Qt::WaitCursor));
  qApp->processEvents();
 
  //reset photo object handle
  photo = newPhoto;
 
  //reset selectionRotated bool to false
  selectionRotated = false;
  
  //update visibility of prev and next buttons
  previousButton->setInvisible( photo->getPrev() == NULL );
  nextButton->setInvisible( photo->getNext() == NULL );
    
  //update view of photo
  selectionInterface->setPhoto( photo->getImageFilename() );  
 
  //created effect preview image  
  effectPreviewImageFilename = ((Window*)qApp->mainWidget())->getTitle()->getAlbum()->getTmpDir() +     "/effectPreviewImage.jpg";
  scaleImage( photo->getImageFilename(), effectPreviewImageFilename, EFFECT_PREVIEW_WIDTH, EFFECT_PREVIEW_HEIGHT );
  selectEffect();
 
  //get full size photo dimensions
  getImageSize( photo->getImageFilename(), imageWidth, imageHeight );
 
  //get display size photo dimensions
  selectionInterface->getDisplaySize( displayWidth, displayHeight );
 
  //auto select region if custom not selected, else select nothing
  if(aspectRatios->currentItem() != 0)
  { selectAspectRatio(); }
  else  
  { selectionInterface->setSelection( QPoint(-1,-1), QPoint(-1, -1) ); }
  
  //emit signal that photo state possibly has changed
  emit photoModified();
  
  //remove busy cursor
  qApp->restoreOverrideCursor();
  qApp->processEvents();
}

References aspectRatios, displayHeight, displayWidth, EFFECT_PREVIEW_HEIGHT, EFFECT_PREVIEW_WIDTH, effectPreviewImageFilename, SelectionInterface::getDisplaySize(), Photo::getImageFilename(), getImageSize(), Photo::getNext(), Photo::getPrev(), imageHeight, imageWidth, nextButton, photo, photoModified(), previousButton, scaleImage(), selectAspectRatio(), selectEffect(), selectionInterface, selectionRotated, ClickableLabel::setInvisible(), SelectionInterface::setPhoto(), and SelectionInterface::setSelection().

Referenced by showFirstPhoto(), showLastPhoto(), showNextPhoto(), and showPrevPhoto().

◆ showPrevPhoto

void EditingInterface::showPrevPhoto ( )

privateslot

Show prev photo.

Definition at line 474 of file editingInterface.cpp.

{ 
  Photo* prevPhoto = photo->getPrev();
 
  if( prevPhoto != NULL && 
      prevPhoto != photo )
  { showNextPrevFirstLastPhoto( prevPhoto ); }
}

References Photo::getPrev(), photo, and showNextPrevFirstLastPhoto().

Referenced by EditingInterface(), and keyPressEvent().

◆ startCorrectTilt

void EditingInterface::startCorrectTilt ( )

privateslot

Enter correct image tilt mode.

Definition at line 1212 of file editingInterface.cpp.

{
  //instruct user to select a horizontal or vertical line in the image by
  //beginning draw line mode in the selection interface
  correctTiltButton->setEnabled( false );
  selectionInterface->enterDrawLineMode();
}

References correctTiltButton, SelectionInterface::enterDrawLineMode(), and selectionInterface.

Referenced by EditingInterface().

◆ tuneLevels

void EditingInterface::tuneLevels ( )

privateslot

Opens levels editor for manual histogram and brightness/contrast adjustments.

Definition at line 727 of file editingInterface.cpp.

{
  //load photo in histogram editor
  //if changes took place update image
  HistogramEditor editor( photo->getImageFilename(), this);
  if( editor.exec() ) 
  { 
    //set busy cursor
    qApp->setOverrideCursor( QCursor(Qt::WaitCursor));
    qApp->processEvents();
 
    //disable user input
    layout->getWindow()->getStatus()->grabInput();
 
    //update image    
    applyImageUpdate( editor.getModifiedImage(), false ); 
 
    //enable user input
    layout->getWindow()->getStatus()->releaseInput();
 
    //remove busy cursor
    qApp->restoreOverrideCursor();
    qApp->processEvents();
  }
}

References applyImageUpdate(), Photo::getImageFilename(), HistogramEditor::getModifiedImage(), Window::getStatus(), LayoutWidget::getWindow(), StatusWidget::grabInput(), layout, photo, and StatusWidget::releaseInput().

Referenced by EditingInterface().

Member Data Documentation

◆ applyEffectButton

QPushButton* EditingInterface::applyEffectButton

private

The apply effect button is disabled when no effect has been chosen.

Definition at line 211 of file editingInterface.h.

Referenced by applyEffect(), and EditingInterface().

◆ aspectRatios

QComboBox* EditingInterface::aspectRatios

private

Widget for selection aspect ratio to crop to.

Definition at line 183 of file editingInterface.h.

Referenced by EditingInterface(), handleAspectRatioChanged(), rotateSelection(), screenResolutionChanged(), selectAspectRatio(), setPhoto(), and showNextPrevFirstLastPhoto().

◆ aspectRatioValues

QSize* EditingInterface::aspectRatioValues

private

array of common aspect ratios to crop to

Definition at line 192 of file editingInterface.h.

Referenced by EditingInterface(), screenResolutionChanged(), and selectAspectRatio().

◆ collection

Subalbum* EditingInterface::collection

private

========== Pointer to backend collection

Definition at line 217 of file editingInterface.h.

Referenced by setPhoto(), showFirstPhoto(), and showLastPhoto().

◆ correctTiltButton

QToolButton* EditingInterface::correctTiltButton

private

The start tilt button is disabled while a line is being selected.

Definition at line 199 of file editingInterface.h.

Referenced by EditingInterface(), finishCorrectTilt(), and startCorrectTilt().

◆ cropButton

QToolButton* EditingInterface::cropButton

private

The crop buttons is disabled when no seletion is present.

Definition at line 202 of file editingInterface.h.

Referenced by EditingInterface(), handleSelectionChanged(), and setPhoto().

◆ displayHeight

int EditingInterface::displayHeight

private

Definition at line 229 of file editingInterface.h.

Referenced by applyImageUpdate(), revertCurrentPhoto(), rotateFlip(), setPhoto(), and showNextPrevFirstLastPhoto().

◆ displayResolutionIndex

int EditingInterface::displayResolutionIndex

private

Index for screen resolution, needed if this value pair changes during program executing.

Definition at line 189 of file editingInterface.h.

Referenced by EditingInterface(), screenResolutionChanged(), and selectAspectRatio().

◆ displayWidth

int EditingInterface::displayWidth

private

Dimension of photo in display coordinates.

Definition at line 229 of file editingInterface.h.

Referenced by applyImageUpdate(), revertCurrentPhoto(), rotateFlip(), setPhoto(), and showNextPrevFirstLastPhoto().

◆ effectPreview

QLabel* EditingInterface::effectPreview

private

Label that shows preview of effect.

Definition at line 214 of file editingInterface.h.

Referenced by EditingInterface(), and selectEffect().

◆ effectPreviewImageFilename

QString EditingInterface::effectPreviewImageFilename

private

Path to scaled down version of image for fast generation of previews of effects.

Definition at line 223 of file editingInterface.h.

Referenced by applyImageUpdate(), revertCurrentPhoto(), rotateFlip(), selectEffect(), setPhoto(), and showNextPrevFirstLastPhoto().

◆ effectsList

QComboBox* EditingInterface::effectsList

private

List of effects that can be applied to photos.

Definition at line 208 of file editingInterface.h.

Referenced by applyEffect(), applyEffect(), EditingInterface(), and setPhoto().

◆ imageHeight

int EditingInterface::imageHeight

private

Definition at line 232 of file editingInterface.h.

Referenced by applyImageUpdate(), revertCurrentPhoto(), rotateFlip(), rotateSelection(), selectAll(), selectAspectRatio(), setPhoto(), and showNextPrevFirstLastPhoto().

◆ imageWidth

int EditingInterface::imageWidth

private

Dimension of photo in image coordinates.

Definition at line 232 of file editingInterface.h.

Referenced by applyImageUpdate(), revertCurrentPhoto(), rotateFlip(), rotateSelection(), selectAll(), selectAspectRatio(), setPhoto(), and showNextPrevFirstLastPhoto().

◆ layout

LayoutWidget* EditingInterface::layout

private

Pointer to the parent layout widget.

Definition at line 226 of file editingInterface.h.

Referenced by adjustGrain(), applyEffect(), colorBalance(), crop(), EditingInterface(), enhanceContrast(), finishCorrectTilt(), removeRedeye(), returnAction(), revertCurrentPhoto(), rotateFlip(), and tuneLevels().

◆ maxDimensions

double* EditingInterface::maxDimensions

private

Definition at line 193 of file editingInterface.h.

Referenced by EditingInterface(), and selectAspectRatio().

◆ nextButton

ClickableLabel * EditingInterface::nextButton

private

Definition at line 176 of file editingInterface.h.

Referenced by EditingInterface(), setPhoto(), and showNextPrevFirstLastPhoto().

◆ orientations

QComboBox* EditingInterface::orientations

private

Definition at line 186 of file editingInterface.h.

◆ photo

Photo* EditingInterface::photo

private

Pointer to backend photo.

Definition at line 220 of file editingInterface.h.

Referenced by adjustGrain(), applyEffect(), applyImageUpdate(), colorBalance(), crop(), currentPhotoRevertable(), EditingInterface(), enhanceContrast(), finishCorrectTilt(), getPhoto(), removeRedeye(), revertCurrentPhoto(), rotateFlip(), setPhoto(), showFirstPhoto(), showLastPhoto(), showNextPhoto(), showNextPrevFirstLastPhoto(), showPrevPhoto(), and tuneLevels().

◆ previousButton

ClickableLabel* EditingInterface::previousButton

private

Buttons for changing the shown image

Definition at line 176 of file editingInterface.h.

Referenced by EditingInterface(), setPhoto(), and showNextPrevFirstLastPhoto().

◆ redEyeReductionButton

ClickableLabel* EditingInterface::redEyeReductionButton

private

The red eye reduction button is disabled when no selection is present.

Definition at line 205 of file editingInterface.h.

Referenced by EditingInterface(), handleSelectionChanged(), and setPhoto().

◆ selectionInterface

SelectionInterface* EditingInterface::selectionInterface

private

This widget scales and displays the photo to fit the available screen space, and provides extensive support for selecting regions of the photo for editing/cropping.

Definition at line 180 of file editingInterface.h.

Referenced by applyImageUpdate(), EditingInterface(), findSelection(), revertCurrentPhoto(), rotateFlip(), rotateSelection(), selectAspectRatio(), setFocus(), setPhoto(), showNextPrevFirstLastPhoto(), and startCorrectTilt().

◆ selectionRotated

bool EditingInterface::selectionRotated

private

state variable indicating if the user wants to use a rotate aspect ratio

Definition at line 196 of file editingInterface.h.

Referenced by applyImageUpdate(), rotateFlip(), rotateSelection(), selectAspectRatio(), setPhoto(), and showNextPrevFirstLastPhoto().

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

Public Slots

Signals

Public Member Functions

Protected Member Functions

Private Slots

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ EditingInterface()

◆ ~EditingInterface()

Member Function Documentation

◆ adjustGrain

◆ applyEffect [1/2]

◆ applyEffect() [2/2]

◆ applyImageUpdate()

◆ colorBalance

◆ crop

◆ currentPhotoRevertable()

◆ enhanceContrast

◆ findSelection()

◆ finishCorrectTilt

◆ flipHorizontal

◆ flipVertical

◆ getPhoto()

◆ handleAspectRatioChanged

◆ handleSelectionChanged

◆ keyPressEvent()

◆ photoModified

◆ removeRedeye

◆ returnAction

◆ revertCurrentPhoto()

◆ rotateFlip()

◆ rotateLeft

◆ rotateRight

◆ rotateSelection

◆ screenResolutionChanged

◆ selectAll()

◆ selectAspectRatio

◆ selectEffect

◆ setFocus

◆ setPhoto()

◆ showFirstPhoto

◆ showLastPhoto

◆ showNextPhoto

◆ showNextPrevFirstLastPhoto()

◆ showPrevPhoto

◆ startCorrectTilt

◆ tuneLevels

Member Data Documentation

◆ applyEffectButton

◆ aspectRatios

◆ aspectRatioValues

◆ collection

◆ correctTiltButton

◆ cropButton

◆ displayHeight

◆ displayResolutionIndex

◆ displayWidth

◆ effectPreview

◆ effectPreviewImageFilename

◆ effectsList

◆ imageHeight

◆ imageWidth

◆ layout

◆ maxDimensions

◆ nextButton

◆ orientations

◆ photo

◆ previousButton

◆ redEyeReductionButton

◆ selectionInterface

◆ selectionRotated