File indexing completed on 2025-04-27 03:58:09

 /* ============================================================
  *
  * This file is a part of digiKam project
  * https://www.digikam.org
  *
  * Date        : 2014-11-15
  * Description : Information for thumbnails
  *
  * SPDX-FileCopyrightText: 2006-2014 by Marcel Wiesweg <marcel dot wiesweg at gmx dot de>
  *
  * SPDX-License-Identifier: GPL-2.0-or-later
  *
  * ============================================================ */
 
 #ifndef DIGIKAM_THUMB_NAIL_INFO_H
 #define DIGIKAM_THUMB_NAIL_INFO_H
 
 // Qt includes
 
 #include <QDateTime>
 #include <QString>
 
 // Local includes
 
 #include "digikam_export.h"
 
 namespace Digikam
 {
 
 class DIGIKAM_EXPORT ThumbnailIdentifier
 {
 public:
 
     ThumbnailIdentifier();
     explicit ThumbnailIdentifier(const QString& filePath);
 
     /**
      * The file path from which the thumbnail shall be generated
      */
     QString   filePath;
 
     /**
      * The database id, which needs to be translated to uniqueHash + fileSize
      */
     qlonglong id;
 };
 
 class DIGIKAM_EXPORT ThumbnailInfo : public ThumbnailIdentifier
 {
 public:
 
     explicit ThumbnailInfo();
     ~ThumbnailInfo()
     {
     };
 
     /**
      * If available, the uniqueHash + fileSize pair for identification
      * of the original file by content.
      */
     QString   uniqueHash;
     qlonglong fileSize;
 
     /**
      * If the original file is at all accessible on disk.
      * May be false if a file on a removable device is used.
      */
     bool      isAccessible;
 
     /**
      * The modification date of the original file.
      * Thumbnail will be regenerated if thumb's modification date is older than this.
      */
     QDateTime modificationDate;
 
     /**
      * Gives a hint at the orientation of the image.
      * This can be used to supersede the Exif information in the file.
      * Will not be used if DMetadata::ORIENTATION_UNSPECIFIED (default value)
      */
     int       orientationHint;
 
     /**
      * The file name (the name, not the directory)
      */
     QString   fileName;
 
     /**
      * The mime type of the original file.
      * Currently "image" or "video" otherwise empty.
      */
     QString   mimeType;
 
     /**
      * A custom identifier, if neither filePath nor uniqueHash are applicable.
      */
     QString   customIdentifier;
 };
 
 // ------------------------------------------------------------------------------------------
 
 class DIGIKAM_EXPORT ThumbnailInfoProvider
 {
 public:
 
     explicit ThumbnailInfoProvider()
     {
     };
 
     virtual ~ThumbnailInfoProvider()
     {
     };
 
     virtual ThumbnailInfo thumbnailInfo(const ThumbnailIdentifier&)=0;
 
 private:
 
     Q_DISABLE_COPY(ThumbnailInfoProvider)
 };
 
 } // namespace Digikam
 
 #endif // DIGIKAM_THUMB_NAIL_INFO_H