lensfuniface.h

Go to the documentation of this file.

/* ============================================================
 *
 * Date        : 2008-02-10
 * Description : a tool to fix automatically camera lens aberrations
 *
 * Copyright (C) 2008      by Adrian Schroeter <adrian at suse dot de>
 * Copyright (C) 2008-2022 by Gilles Caulier <caulier dot gilles at gmail dot com>
 *
 * This program is free software; you can redistribute it
 * and/or modify it under the terms of the GNU General
 * Public License as published by the Free Software Foundation;
 * either version 2, or (at your option)
 * any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * ============================================================ */
 
#ifndef DIGIKAM_LENS_FUN_IFACE_H
#define DIGIKAM_LENS_FUN_IFACE_H
 
// LensFun includes
 
/*
 * Pragma directives to reduce warnings from Lensfun header files.
 *
 * TODO: lensfun version > 0.3.2 introduce deprecated methods for the future.
 * digiKam Code need to be ported to new API when Lensfun 0.4.0 will be releaed.
 *
 */
#if defined(Q_CC_GNU)
#   pragma GCC diagnostic push
#   pragma GCC diagnostic ignored "-Wzero-as-null-pointer-constant"
#   pragma GCC diagnostic ignored "-Wdeprecated-declarations"
#endif
 
#if defined(Q_CC_CLANG)
#   pragma clang diagnostic push
#   pragma clang diagnostic ignored "-Wmismatched-tags"
#   pragma clang diagnostic ignored "-Wdeprecated-declarations"
#endif
 
#include <lensfun.h>
 
// Restore warnings
#if defined(Q_CC_GNU)
#   pragma GCC diagnostic pop
#endif
 
#if defined(Q_CC_CLANG)
#   pragma clang diagnostic pop
#endif
 
// Local includes
 
#include "dmetadata.h"
#include "digikam_export.h"
#include "lensfunfilter.h"
 
namespace Digikam
{
 
class DIGIKAM_EXPORT LensFunIface
{
public:
 
    typedef const lfCamera* DevicePtr;
    typedef const lfLens*   LensPtr;
    typedef QList<LensPtr>  LensList;
 
    enum MetadataMatch
    {
        MetadataUnavailable  = -2,
        MetadataNoMatch      = -1,
        MetadataPartialMatch = 0,
        MetadataExactMatch   = 1
    };
 
public:
 
    explicit LensFunIface();
    ~LensFunIface();
 
    void setFilterSettings(const LensFunContainer& other);
 
    void             setSettings(const LensFunContainer& other);
    LensFunContainer settings()                                     const;
 
    LensPtr usedLens()                                              const;
    void    setUsedLens(LensPtr lens);
 
    DevicePtr usedCamera()                                          const;
    void      setUsedCamera(DevicePtr cam);
 
    lfDatabase*            lensFunDataBase()                        const;
    const lfCamera* const* lensFunCameras()                         const;
 
    DevicePtr findCamera(const QString& make, const QString& model) const;
    LensPtr   findLens(const QString& model)                        const;
 
    MetadataMatch findFromMetadata(DMetadata* const meta);
 
    bool supportsDistortion()                                       const;
    bool supportsCCA()                                              const;
    bool supportsVig()                                              const;
    bool supportsGeometry()                                         const;
 
    QString makeDescription()                                       const;
 
    QString modelDescription()                                      const;
 
    QString lensDescription()                                       const;
 
    static QString lensFunVersion();
 
private:
 
    QString  metadataMatchDebugStr(MetadataMatch val)               const;
    LensList findLenses(const lfCamera* const camera,
                        const QString& lensDesc,
                        const QString& lensMaker=QString())         const;
 
    double checkSimilarity(const QString& a, const QString& b)      const;
 
private:
 
    // Disable
    LensFunIface(const LensFunIface&)            = delete;
    LensFunIface& operator=(const LensFunIface&) = delete;
 
private:
 
    class Private;
    Private* const d;
};
 
} // namespace Digikam
 
Q_DECLARE_METATYPE(Digikam::LensFunIface::DevicePtr)
Q_DECLARE_METATYPE(Digikam::LensFunIface::LensPtr)
 
#endif // DIGIKAM_LENS_FUN_IFACE_H