Content of file saveSnapshot.cpp

/****************************************************************************

 Copyright (C) 2002-2014 Gilles Debunne. All rights reserved.

 This file is part of the QGLViewer library version 2.8.0.

 http://www.libqglviewer.com - contact@libqglviewer.com

 This file may be used under the terms of the GNU General Public License 
 versions 2.0 or 3.0 as published by the Free Software Foundation and
 appearing in the LICENSE file included in the packaging of this file.
 In addition, as a special exception, Gilles Debunne gives you certain 
 additional rights, described in the file GPL_EXCEPTION in this package.

 libQGLViewer uses dual licensing. Commercial/proprietary software must
 purchase a libQGLViewer Commercial License.

 This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
 WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

*****************************************************************************/

#include "qglviewer.h"

#ifndef NO_VECTORIAL_RENDER
#include "VRender/VRender.h"
#include "ui_VRenderInterface.h"
#endif

#include "ui_ImageInterface.h"

// Output format list
#include <QImageWriter>

#include <qapplication.h>
#include <qcursor.h>
#include <qfiledialog.h>
#include <qfileinfo.h>
#include <qinputdialog.h>
#include <qmap.h>
#include <qmessagebox.h>
#include <qprogressdialog.h>

using namespace std;

////// Static global variables - local to this file //////
// List of available output file formats, formatted for QFileDialog.
static QString formats;
// Converts QFileDialog resulting format to Qt snapshotFormat.
static QMap<QString, QString> Qtformat;
// Converts Qt snapshotFormat to QFileDialog menu string.
static QMap<QString, QString> FDFormatString;
// Converts snapshotFormat to file extension
static QMap<QString, QString> extension;

/*! Sets snapshotFileName(). */
void QGLViewer::setSnapshotFileName(const QString &name) {
  snapshotFileName_ = QFileInfo(name).absoluteFilePath();
}

#ifndef DOXYGEN
const QString &QGLViewer::snapshotFilename() const {
  qWarning("snapshotFilename is deprecated. Use snapshotFileName() (uppercase "
           "N) instead.");
  return snapshotFileName();
}
#endif

/*! Opens a dialog that displays the different available snapshot formats.

Then calls setSnapshotFormat() with the selected one (unless the user cancels).

Returns \c false if the user presses the Cancel button and \c true otherwise. */
bool QGLViewer::openSnapshotFormatDialog() {
  bool ok = false;
#if QT_VERSION < QT_VERSION_CHECK(6, 0, 0)
  QStringList list = formats.split(";;", QString::SkipEmptyParts);
#else
  QStringList list = formats.split(";;", Qt::SkipEmptyParts);
#endif
  int current = list.indexOf(FDFormatString[snapshotFormat()]);
  QString format =
      QInputDialog::getItem(this, "Snapshot format", "Select a snapshot format",
                            list, current, false, &ok);
  if (ok)
    setSnapshotFormat(Qtformat[format]);
  return ok;
}

// Finds all available Qt output formats, so that they can be available in
// saveSnapshot dialog. Initialize snapshotFormat() to the first one.
void QGLViewer::initializeSnapshotFormats() {
  QList<QByteArray> list = QImageWriter::supportedImageFormats();
  QStringList formatList;
  for (int i = 0; i < list.size(); ++i)
    formatList << QString(list.at(i).toUpper());
//        qWarning("Available image formats: ");
//        QStringList::Iterator it = formatList.begin();
//        while( it != formatList.end() )
//  	      qWarning((*it++).);  QT4 change this. qWarning no longer accepts
//  QString

#ifndef NO_VECTORIAL_RENDER
  // We add the 3 vectorial formats to the list
  formatList += "EPS";
  formatList += "PS";
  formatList += "XFIG";
#endif

  // Check that the interesting formats are available and add them in "formats"
  // Unused formats: XPM XBM PBM PGM
  QStringList QtText, MenuText, Ext;
  QtText += "JPEG";
  MenuText += "JPEG (*.jpg)";
  Ext += "jpg";
  QtText += "PNG";
  MenuText += "PNG (*.png)";
  Ext += "png";
  QtText += "EPS";
  MenuText += "Encapsulated Postscript (*.eps)";
  Ext += "eps";
  QtText += "PS";
  MenuText += "Postscript (*.ps)";
  Ext += "ps";
  QtText += "PPM";
  MenuText += "24bit RGB Bitmap (*.ppm)";
  Ext += "ppm";
  QtText += "BMP";
  MenuText += "Windows Bitmap (*.bmp)";
  Ext += "bmp";
  QtText += "XFIG";
  MenuText += "XFig (*.fig)";
  Ext += "fig";

  QStringList::iterator itText = QtText.begin();
  QStringList::iterator itMenu = MenuText.begin();
  QStringList::iterator itExt = Ext.begin();

  while (itText != QtText.end()) {
    // QMessageBox::information(this, "Snapshot ", "Trying format\n"+(*itText));
    if (formatList.contains((*itText))) {
      // QMessageBox::information(this, "Snapshot ", "Recognized
      // format\n"+(*itText));
      if (formats.isEmpty())
        setSnapshotFormat(*itText);
      else
        formats += ";;";
      formats += (*itMenu);
      Qtformat[(*itMenu)] = (*itText);
      FDFormatString[(*itText)] = (*itMenu);
      extension[(*itText)] = (*itExt);
    }
    // Synchronize parsing
    itText++;
    itMenu++;
    itExt++;
  }
}

// Returns false if the user refused to use the fileName
static bool checkFileName(QString &fileName, QWidget *widget,
                          const QString &snapshotFormat) {
  if (fileName.isEmpty())
    return false;

  // Check that extension has been provided
  QFileInfo info(fileName);

  if (info.suffix().isEmpty()) {
    // No extension given. Silently add one
    if (fileName.right(1) != ".")
      fileName += ".";
    fileName += extension[snapshotFormat];
    info.setFile(fileName);
  } else if (info.suffix() != extension[snapshotFormat]) {
    // Extension is not appropriate. Propose a modification
    QString modifiedName = info.absolutePath() + '/' + info.baseName() + "." +
                           extension[snapshotFormat];
    QFileInfo modifInfo(modifiedName);
    int i = (QMessageBox::warning(
        widget, "Wrong extension",
        info.fileName() + " has a wrong extension.\nSave as " +
            modifInfo.fileName() + " instead ?",
        QMessageBox::Yes, QMessageBox::No, QMessageBox::Cancel));
    if (i == QMessageBox::Cancel)
      return false;

    if (i == QMessageBox::Yes) {
      fileName = modifiedName;
      info.setFile(fileName);
    }
  }

  return true;
}

#ifndef NO_VECTORIAL_RENDER
// static void drawVectorial(void* param)
void drawVectorial(void *param) { ((QGLViewer *)param)->drawVectorial(); }

#ifndef DOXYGEN
class ProgressDialog {
public:
  static void showProgressDialog(QOpenGLWidget *parent);
  static void updateProgress(float progress, const QString &stepString);
  static void hideProgressDialog();

private:
  static QProgressDialog *progressDialog;
};

QProgressDialog *ProgressDialog::progressDialog = nullptr;

void ProgressDialog::showProgressDialog(QOpenGLWidget *parent) {
  progressDialog = new QProgressDialog(parent);
  progressDialog->setWindowTitle("Image rendering progress");
  progressDialog->setMinimumSize(300, 40);
  progressDialog->setCancelButton(nullptr);
  progressDialog->show();
}

void ProgressDialog::updateProgress(float progress, const QString &stepString) {
  progressDialog->setValue(int(progress * 100));
  QString message(stepString);
  if (message.length() > 33)
    message = message.left(17) + "..." + message.right(12);
  progressDialog->setLabelText(message);
  progressDialog->update();
  qApp->processEvents();
}

void ProgressDialog::hideProgressDialog() {
  progressDialog->close();
  delete progressDialog;
  progressDialog = nullptr;
}

class VRenderInterface : public QDialog, public Ui::VRenderInterface {
public:
  VRenderInterface(QWidget *parent) : QDialog(parent) { setupUi(this); }
};

#endif // DOXYGEN

// Pops-up a vectorial output option dialog box and save to fileName
// Returns -1 in case of Cancel, 0 for success and (todo) error code in case of
// problem.
static int saveVectorialSnapshot(const QString &fileName, QOpenGLWidget *widget,
                                 const QString &snapshotFormat) {
  static VRenderInterface *VRinterface = nullptr;

  if (!VRinterface)
    VRinterface = new VRenderInterface(widget);

  // Configure interface according to selected snapshotFormat
  if (snapshotFormat == "XFIG") {
    VRinterface->tightenBBox->setEnabled(false);
    VRinterface->colorBackground->setEnabled(false);
  } else {
    VRinterface->tightenBBox->setEnabled(true);
    VRinterface->colorBackground->setEnabled(true);
  }

  if (VRinterface->exec() == QDialog::Rejected)
    return -1;

  vrender::VRenderParams vparams;
  vparams.setFilename(fileName);

  if (snapshotFormat == "EPS")
    vparams.setFormat(vrender::VRenderParams::EPS);
  if (snapshotFormat == "PS")
    vparams.setFormat(vrender::VRenderParams::PS);
  if (snapshotFormat == "XFIG")
    vparams.setFormat(vrender::VRenderParams::XFIG);

  vparams.setOption(vrender::VRenderParams::CullHiddenFaces,
                    !(VRinterface->includeHidden->isChecked()));
  vparams.setOption(vrender::VRenderParams::OptimizeBackFaceCulling,
                    VRinterface->cullBackFaces->isChecked());
  vparams.setOption(vrender::VRenderParams::RenderBlackAndWhite,
                    VRinterface->blackAndWhite->isChecked());
  vparams.setOption(vrender::VRenderParams::AddBackground,
                    VRinterface->colorBackground->isChecked());
  vparams.setOption(vrender::VRenderParams::TightenBoundingBox,
                    VRinterface->tightenBBox->isChecked());

  switch (VRinterface->sortMethod->currentIndex()) {
  case 0:
    vparams.setSortMethod(vrender::VRenderParams::NoSorting);
    break;
  case 1:
    vparams.setSortMethod(vrender::VRenderParams::BSPSort);
    break;
  case 2:
    vparams.setSortMethod(vrender::VRenderParams::TopologicalSort);
    break;
  case 3:
    vparams.setSortMethod(vrender::VRenderParams::AdvancedTopologicalSort);
    break;
  default:
    qWarning("VRenderInterface::saveVectorialSnapshot: Unknown SortMethod");
  }

  vparams.setProgressFunction(&ProgressDialog::updateProgress);
  ProgressDialog::showProgressDialog(widget);
  widget->makeCurrent();
  widget->raise();
  vrender::VectorialRender(drawVectorial, (void *)widget, vparams);
  ProgressDialog::hideProgressDialog();
  widget->setCursor(QCursor(Qt::ArrowCursor));

  // Should return vparams.error(), but this is currently not set.
  return 0;
}
#endif // NO_VECTORIAL_RENDER

class ImageInterface : public QDialog, public Ui::ImageInterface {
public:
  ImageInterface(QWidget *parent) : QDialog(parent) { setupUi(this); }
};

// Pops-up an image settings dialog box and save to fileName.
// Returns false in case of problem.
bool QGLViewer::saveImageSnapshot(const QString &fileName) {
  static ImageInterface *imageInterface = nullptr;

  if (!imageInterface)
    imageInterface = new ImageInterface(this);

  imageInterface->imgWidth->setValue(width());
  imageInterface->imgHeight->setValue(height());

  imageInterface->imgQuality->setValue(snapshotQuality());

  if (imageInterface->exec() == QDialog::Rejected)
    return true;

  // Hide closed dialog
  qApp->processEvents();

  setSnapshotQuality(imageInterface->imgQuality->value());

  QColor previousBGColor = backgroundColor();
  if (imageInterface->whiteBackground->isChecked())
    setBackgroundColor(Qt::white);

  QSize finalSize(imageInterface->imgWidth->value(),
                  imageInterface->imgHeight->value());

  qreal oversampling = imageInterface->oversampling->value();
  QSize subSize(int(this->width() / oversampling),
                int(this->height() / oversampling));

  qreal aspectRatio = width() / static_cast<qreal>(height());
  qreal newAspectRatio =
      finalSize.width() / static_cast<qreal>(finalSize.height());

  qreal zNear = camera()->zNear();
  qreal zFar = camera()->zFar();

  qreal xMin, yMin;
  bool expand = imageInterface->expandFrustum->isChecked();
  if (camera()->type() == qglviewer::Camera::PERSPECTIVE)
    if ((expand && (newAspectRatio > aspectRatio)) ||
        (!expand && (newAspectRatio < aspectRatio))) {
      yMin = zNear * tan(camera()->fieldOfView() / 2.0);
      xMin = newAspectRatio * yMin;
    } else {
      xMin = zNear * tan(camera()->fieldOfView() / 2.0) * aspectRatio;
      yMin = xMin / newAspectRatio;
    }
  else {
    GLdouble width, height;
    camera()->getOrthoWidthHeight(width, height);
    xMin = qreal(width);
    yMin = qreal(height);
    if ((expand && (newAspectRatio > aspectRatio)) ||
        (!expand && (newAspectRatio < aspectRatio)))
      xMin = newAspectRatio * yMin;
    else
      yMin = xMin / newAspectRatio;
  }

  QImage image(finalSize.width(), finalSize.height(), QImage::Format_ARGB32);

  if (image.isNull()) {
    QMessageBox::warning(this, "Image saving error",
                         "Unable to create resulting image", QMessageBox::Ok,
                         QMessageBox::NoButton);
    return false;
  }

  // ProgressDialog disabled since it interfers with the screen grabing mecanism
  // on some platforms. Too bad. ProgressDialog::showProgressDialog(this);

  qreal scaleX = subSize.width() / static_cast<qreal>(finalSize.width());
  qreal scaleY = subSize.height() / static_cast<qreal>(finalSize.height());

  qreal deltaX = 2.0 * xMin * scaleX;
  qreal deltaY = 2.0 * yMin * scaleY;

  int nbX = finalSize.width() / subSize.width();
  int nbY = finalSize.height() / subSize.height();

  // Extra subimage on the right/bottom border(s) if needed
  if (nbX * subSize.width() < finalSize.width())
    nbX++;
  if (nbY * subSize.height() < finalSize.height())
    nbY++;

  makeCurrent();

  // tileRegion_ is used by startScreenCoordinatesSystem to appropriately set
  // the local coordinate system when tiling
  tileRegion_ = new TileRegion();
  qreal tileXMin, tileWidth, tileYMin, tileHeight;
  if ((expand && (newAspectRatio > aspectRatio)) ||
      (!expand && (newAspectRatio < aspectRatio))) {
    qreal tileTotalWidth = newAspectRatio * height();
    tileXMin = (width() - tileTotalWidth) / 2.0;
    tileWidth = tileTotalWidth * scaleX;
    tileYMin = 0.0;
    tileHeight = height() * scaleY;
    tileRegion_->textScale = 1.0 / scaleY;
  } else {
    qreal tileTotalHeight = width() / newAspectRatio;
    tileYMin = (height() - tileTotalHeight) / 2.0;
    tileHeight = tileTotalHeight * scaleY;
    tileXMin = 0.0;
    tileWidth = width() * scaleX;
    tileRegion_->textScale = 1.0 / scaleX;
  }

  int count = 0;
  for (int i = 0; i < nbX; i++)
    for (int j = 0; j < nbY; j++) {
      preDraw();

      // Change projection matrix
      glMatrixMode(GL_PROJECTION);
      glLoadIdentity();
      if (camera()->type() == qglviewer::Camera::PERSPECTIVE)
        glFrustum(-xMin + i * deltaX, -xMin + (i + 1) * deltaX,
                  yMin - (j + 1) * deltaY, yMin - j * deltaY, zNear, zFar);
      else
        glOrtho(-xMin + i * deltaX, -xMin + (i + 1) * deltaX,
                yMin - (j + 1) * deltaY, yMin - j * deltaY, zNear, zFar);
      glMatrixMode(GL_MODELVIEW);

      tileRegion_->xMin = tileXMin + i * tileWidth;
      tileRegion_->xMax = tileXMin + (i + 1) * tileWidth;
      tileRegion_->yMin = tileYMin + j * tileHeight;
      tileRegion_->yMax = tileYMin + (j + 1) * tileHeight;

      draw();
      postDraw();

      // ProgressDialog::hideProgressDialog();
      // qApp->processEvents();

      QImage snapshot = QOpenGLWidget::grabFramebuffer();

      // ProgressDialog::showProgressDialog(this);
      // ProgressDialog::updateProgress(count / (qreal)(nbX*nbY),
      // "Generating image
      // ["+QString::number(count)+"/"+QString::number(nbX*nbY)+"]");
      // qApp->processEvents();

      QImage subImage = snapshot.scaled(subSize, Qt::IgnoreAspectRatio,
                                        Qt::SmoothTransformation);

      // Copy subImage in image
      for (int ii = 0; ii < subSize.width(); ii++) {
        int fi = i * subSize.width() + ii;
        if (fi == image.width())
          break;
        for (int jj = 0; jj < subSize.height(); jj++) {
          int fj = j * subSize.height() + jj;
          if (fj == image.height())
            break;
          image.setPixel(fi, fj, subImage.pixel(ii, jj));
        }
      }
      count++;
    }

  bool saveOK = image.save(fileName, snapshotFormat().toLatin1().constData(),
                           snapshotQuality());

  // ProgressDialog::hideProgressDialog();
  // setCursor(QCursor(Qt::ArrowCursor));

  delete tileRegion_;
  tileRegion_ = nullptr;

  if (imageInterface->whiteBackground->isChecked())
    setBackgroundColor(previousBGColor);

  return saveOK;
}

/*! Saves a snapshot of the current image displayed by the widget.

 Options are set using snapshotFormat(), snapshotFileName() and
 snapshotQuality(). For non vectorial image formats, the image size is equal to
 the current viewer's dimensions (see width() and height()). See
 snapshotFormat() for details on supported formats.

 If \p automatic is \c false (or if snapshotFileName() is empty), a file dialog
 is opened to ask for the file name.

 When \p automatic is \c true, the file name is set to \c NAME-NUMBER, where \c
 NAME is snapshotFileName() and \c NUMBER is snapshotCounter(). The
 snapshotCounter() is automatically incremented after each snapshot saving. This
 is useful to create videos from your application: \code void Viewer::init()
 {
   resize(720, 576); // PAL DV format (use 720x480 for NTSC DV)
   connect(this, SIGNAL(drawFinished(bool)), SLOT(saveSnapshot(bool)));
 }
 \endcode
 Then call draw() in a loop (for instance using animate() and/or a camera()
 KeyFrameInterpolator replay) to create your image sequence.

 If you want to create a Quicktime VR panoramic sequence, simply use code like
 this: \code void Viewer::createQuicktime()
 {
   const int nbImages = 36;
   for (int i=0; i<nbImages; ++i)
         {
           camera()->setOrientation(2.0*M_PI/nbImages, 0.0); // Theta-Phi
 orientation showEntireScene(); update(); // calls draw(), which emits
 drawFinished(), which calls saveSnapshot()
         }
 }
 \endcode

 If snapshotCounter() is negative, no number is appended to snapshotFileName()
 and the snapshotCounter() is not incremented. This is useful to force the
 creation of a file, overwriting the previous one.

 When \p overwrite is set to \c false (default), a window asks for confirmation
 if the file already exists. In \p automatic mode, the snapshotCounter() is
 incremented (if positive) until a non-existing file name is found instead.
 Otherwise the file is overwritten without confirmation.

 The VRender library was written by Cyril Soler (Cyril dot Soler at imag dot
 fr). If the generated PS or EPS file is not properly displayed, remove the
 anti-aliasing option in your postscript viewer.

 \note In order to correctly grab the frame buffer, the QGLViewer window is
 raised in front of other windows by this method. */
void QGLViewer::saveSnapshot(bool automatic, bool overwrite) {
  // Ask for file name
  if (snapshotFileName().isEmpty() || !automatic) {
    QString fileName;
    QString selectedFormat = FDFormatString[snapshotFormat()];
    fileName = QFileDialog::getSaveFileName(
        this, "Choose a file name to save under", snapshotFileName(), formats,
        &selectedFormat,
        overwrite ? QFileDialog::DontConfirmOverwrite
                  : QFlags<QFileDialog::Option>(0));
'QFlags' is deprecated: Use default constructor instead
setSnapshotFormat(Qtformat[selectedFormat]); if (checkFileName(fileName, this, snapshotFormat())) setSnapshotFileName(fileName); else return; } QFileInfo fileInfo(snapshotFileName()); if ((automatic) && (snapshotCounter() >= 0)) { // In automatic mode, names have a number appended const QString baseName = fileInfo.baseName(); QString count = QString("%1").arg(snapshotCounter_++, 4, 10, QChar('0')); QString suffix; suffix = fileInfo.suffix(); if (suffix.isEmpty()) suffix = extension[snapshotFormat()]; fileInfo.setFile(fileInfo.absolutePath() + '/' + baseName + '-' + count + '.' + suffix); if (!overwrite) while (fileInfo.exists()) { count = QString("%1").arg(snapshotCounter_++, 4, 10, QChar('0')); fileInfo.setFile(fileInfo.absolutePath() + '/' + baseName + '-' + count + '.' + fileInfo.suffix()); } } bool saveOK; #ifndef NO_VECTORIAL_RENDER if ((snapshotFormat() == "EPS") || (snapshotFormat() == "PS") || (snapshotFormat() == "XFIG")) // Vectorial snapshot. -1 means cancel, 0 is ok, >0 (should be) an error saveOK = (saveVectorialSnapshot(fileInfo.filePath(), this, snapshotFormat()) <= 0); else #endif if (automatic) { QImage snapshot = frameBufferSnapshot(); saveOK = snapshot.save(fileInfo.filePath(), snapshotFormat().toLatin1().constData(), snapshotQuality()); } else saveOK = saveImageSnapshot(fileInfo.filePath()); if (!saveOK) QMessageBox::warning(this, "Snapshot problem", "Unable to save snapshot in\n" + fileInfo.filePath()); } QImage QGLViewer::frameBufferSnapshot() { // Viewer must be on top of other windows. makeCurrent(); raise(); // Hack: Qt has problems if the frame buffer is grabbed after QFileDialog is // displayed. We grab the frame buffer before, even if it might be not // necessary (vectorial rendering). The problem could not be reproduced on a // simple example to submit a Qt bug. However, only grabs the backgroundImage // in the eponym example. May come from the driver. return QOpenGLWidget::grabFramebuffer(); } /*! Same as saveSnapshot(), except that it uses \p fileName instead of snapshotFileName(). If \p fileName is empty, opens a file dialog to select the name. Snapshot settings are set from snapshotFormat() and snapshotQuality(). Asks for confirmation when \p fileName already exists and \p overwrite is \c false (default). \attention If \p fileName is a char* (as is "myFile.jpg"), it may be casted into a \c bool, and the other saveSnapshot() method may be used instead. Pass QString("myFile.jpg") as a parameter to prevent this. */ void QGLViewer::saveSnapshot(const QString &fileName, bool overwrite) { const QString previousName = snapshotFileName(); const int previousCounter = snapshotCounter(); setSnapshotFileName(fileName); setSnapshotCounter(-1); saveSnapshot(true, overwrite); setSnapshotFileName(previousName); setSnapshotCounter(previousCounter); } /*! Takes a snapshot of the current display and pastes it to the clipboard. This action is activated by the KeyboardAction::SNAPSHOT_TO_CLIPBOARD enum, binded to \c Ctrl+C by default. */ void QGLViewer::snapshotToClipboard() { QClipboard *cb = QApplication::clipboard(); cb->setImage(frameBufferSnapshot()); }