tags_int.hpp

Go to the documentation of this file.

// ***************************************************************** -*- C++ -*-
/*
 * Copyright (C) 2004-2018 Exiv2 authors
 * This program is part of the Exiv2 distribution.
 *
 * 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
 * of the License, 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.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, 5th Floor, Boston, MA 02110-1301 USA.
 */
#ifndef TAGS_INT_HPP_
#define TAGS_INT_HPP_

// *****************************************************************************
// included header files
#include "types.hpp"
#include "tags.hpp"
#include "value.hpp"

// + standard includes
#include <string>
#include <iostream>
#include <memory>

// *****************************************************************************
// namespace extensions

namespace Exiv2 {
    class ExifData;

    namespace Internal {

// *****************************************************************************
// class definitions

    enum IfdId {
        ifdIdNotSet,
        ifd0Id,
        ifd1Id,
        ifd2Id,
        ifd3Id,
        exifId,
        gpsId,
        iopId,
        mpfId,
        subImage1Id,
        subImage2Id,
        subImage3Id,
        subImage4Id,
        subImage5Id,
        subImage6Id,
        subImage7Id,
        subImage8Id,
        subImage9Id,
        subThumb1Id,
        panaRawId,
        mnId,
        canonId,
        canonCsId,
        canonSiId,
        canonCfId,
        canonPiId,
        canonPaId,
        canonTiId,
        canonFiId,
        canonPrId,
        casioId,
        casio2Id,
        fujiId,
        minoltaId,
        minoltaCs5DId,
        minoltaCs7DId,
        minoltaCsOldId,
        minoltaCsNewId,
        nikon1Id,
        nikon2Id,
        nikon3Id,
        nikonPvId,
        nikonVrId,
        nikonPcId,
        nikonWtId,
        nikonIiId,
        nikonAfId,
        nikonAf21Id,
        nikonAf22Id,
        nikonAFTId,
        nikonFiId,
        nikonMeId,
        nikonFl1Id,
        nikonFl2Id,
        nikonFl3Id,
        nikonSi1Id,
        nikonSi2Id,
        nikonSi3Id,
        nikonSi4Id,
        nikonSi5Id,
        nikonSi6Id,
        nikonLd1Id,
        nikonLd2Id,
        nikonLd3Id,
        nikonCb1Id,
        nikonCb2Id,
        nikonCb2aId,
        nikonCb2bId,
        nikonCb3Id,
        nikonCb4Id,
        olympusId,
        olympus2Id,
        olympusCsId,
        olympusEqId,
        olympusRdId,
        olympusRd2Id,
        olympusIpId,
        olympusFiId,
        olympusFe1Id,
        olympusFe2Id,
        olympusFe3Id,
        olympusFe4Id,
        olympusFe5Id,
        olympusFe6Id,
        olympusFe7Id,
        olympusFe8Id,
        olympusFe9Id,
        olympusRiId,
        panasonicId,
        pentaxId,
        pentaxDngId,
        samsung2Id,
        samsungPvId,
        samsungPwId,
        sigmaId,
        sony1Id,
        sony2Id,
        sonyMltId,
        sony1CsId,
        sony1Cs2Id,
        sony2CsId,
        sony2Cs2Id,
        sony2FpId,
        sony1MltCs7DId,
        sony1MltCsOldId,
        sony1MltCsNewId,
        sony1MltCsA100Id,
        lastId,
        ignoreId = lastId
    };

    enum SectionId { sectionIdNotSet,
                     imgStruct, recOffset, imgCharacter, otherTags, exifFormat,
                     exifVersion, imgConfig, userInfo, relatedFile, dateTime,
                     captureCond, gpsTags, iopTags, mpfTags, makerTags, dngTags, panaRaw,
                     tiffEp, tiffPm6, adobeOpi,
                     lastSectionId };

    struct SectionInfo {
        SectionId sectionId_;                   
        const char* name_;                      
        const char* desc_;                      
    };

    struct TagDetails {
        int64_t val_;                           
        const char* label_;                     

       bool operator==(long key) const { return val_ == key; }
    }; // struct TagDetails

    struct TagDetailsBitmask {
        uint32_t mask_;                         
        const char* label_;                     
    }; // struct TagDetailsBitmask

    struct TagVocabulary {
        const char* voc_;                       
        const char* label_;                     

        bool operator==(const std::string& key) const;
    }; // struct TagDetails

    template <int N, const TagDetails (&array)[N]>
    std::ostream& printTag(std::ostream& os, const Value& value, const ExifData*)
    {
        const TagDetails* td = find(array, value.toLong());
        if (td) {
            os << exvGettext(td->label_);
        }
        else {
            os << "(" << value << ")";
        }
        return os;
    }

#define EXV_PRINT_TAG(array) printTag<EXV_COUNTOF(array), array>

    template <int N, const TagDetailsBitmask (&array)[N]>
    std::ostream& printTagBitmask(std::ostream& os, const Value& value, const ExifData*)
    {
        const uint32_t val = static_cast<uint32_t>(value.toLong());
        if (val == 0 && N > 0) {
            const TagDetailsBitmask* td = *(&array);
            if (td->mask_ == 0) return os << exvGettext(td->label_);
        }
        bool sep = false;
        for (int i = 0; i < N; ++i) {
            // *& acrobatics is a workaround for a MSVC 7.1 bug
            const TagDetailsBitmask* td = *(&array) + i;

            if (val & td->mask_) {
                if (sep) {
                    os << ", " << exvGettext(td->label_);
                }
                else {
                    os << exvGettext(td->label_);
                    sep = true;
                }
            }
        }
        return os;
    }

#define EXV_PRINT_TAG_BITMASK(array) printTagBitmask<EXV_COUNTOF(array), array>

    template <int N, const TagVocabulary (&array)[N]>
    std::ostream& printTagVocabulary(std::ostream& os, const Value& value, const ExifData*)
    {
        const TagVocabulary* td = find(array, value.toString());
        if (td) {
            os << exvGettext(td->label_);
        }
        else {
            os << "(" << value << ")";
        }
        return os;
    }

#define EXV_PRINT_VOCABULARY(array) printTagVocabulary<EXV_COUNTOF(array), array>

// *****************************************************************************
// free functions

    const TagInfo* ifdTagList();
    const TagInfo* exifTagList();
    const TagInfo* iopTagList();
    const TagInfo* gpsTagList();
    const TagInfo* mnTagList();
    const TagInfo* mpfTagList();

    const GroupInfo* groupList();
    const TagInfo* tagList(const std::string& groupName);

    IfdId groupId(const std::string& groupName);
    const char* ifdName(IfdId ifdId);
    const char* groupName(IfdId ifdId);

    bool isMakerIfd(IfdId ifdId);
    bool isExifIfd(IfdId ifdId);

    void taglist(std::ostream& os, IfdId ifdId);
    const TagInfo* tagList(IfdId ifdId);
    const TagInfo* tagInfo(uint16_t tag, IfdId ifdId);
    const TagInfo* tagInfo(const std::string& tagName, IfdId ifdId);
    uint16_t tagNumber(const std::string& tagName, IfdId ifdId);


    std::ostream& printValue(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& printLong(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& printFloat(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& printDegrees(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& printUcs2(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& printExifUnit(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x0000(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x0005(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x0006(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x0007(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x0009(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x000a(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x000c(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x0019(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x001e(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x0112(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x0213(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x8298(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x829a(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x829d(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x8822(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x8827(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x9101(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x9201(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x9202(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x9204(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x9206(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x9207(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x9208(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x920a(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0x9286(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0xa001(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0xa217(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0xa300(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0xa301(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0xa401(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0xa402(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0xa403(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0xa404(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0xa405(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0xa406(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0xa407(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0xa409(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& print0xa40c(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& printGPSDirRef(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& printNormalSoftHard(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& printExifVersion(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& printXmpVersion(std::ostream& os, const Value& value, const ExifData*);
    std::ostream& printXmpDate(std::ostream& os, const Value& value, const ExifData*);

    float fnumber(float apertureValue);

    URational exposureTime(float shutterSpeedValue);

}}                                      // namespace Internal, Exiv2

#endif                                  // #ifndef TAGS_INT_HPP_