// ***************************************************************** -*- C++ -*- /* * Copyright (C) 2004-2008 Andreas Huggel * * 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. */ /*! @file nikonmn.hpp @brief Nikon MakerNote formats.
References:
MakerNote EXIF Tag of the Nikon 990 by Max Lyons
Exif file format by TsuruZoh Tachibanaya
"EXIFutils Field Reference Guide"
Nikon Type 3 Makernote Tags Definition of the PHP JPEG Metadata Toolkit by Evan Hunter
ExifTool by Phil Harvey
Email communication with Robert Rottmerhusen
Email communication with Roger Larsson
@version $Rev$ @author Andreas Huggel (ahu) ahuggel@gmx.net @author Gilles Caulier (gc) caulier dot gilles at kdemail dot net @date 17-May-04, ahu: created
25-May-04, ahu: combined all Nikon formats in one component */ #ifndef NIKONMN_HPP_ #define NIKONMN_HPP_ // ***************************************************************************** // included header files #include "types.hpp" #include "makernote.hpp" #include "tags.hpp" // + standard includes #include #include #include // ***************************************************************************** // namespace extensions namespace Exiv2 { // ***************************************************************************** // class declarations class Value; // ***************************************************************************** // free functions /*! @brief Return an auto-pointer to a newly created empty MakerNote initialized to operate in the memory management model indicated. The caller owns this copy and the auto-pointer ensures that it will be deleted. @param alloc Memory management model for the new MakerNote. Determines if memory required to store data should be allocated and deallocated (true) or not (false). If false, only pointers to the buffer provided to read() will be kept. See Ifd for more background on this concept. @param buf Pointer to the makernote character buffer (not used). @param len Length of the makernote character buffer (not used). @param byteOrder Byte order in which the Exif data (and possibly the makernote) is encoded (not used). @param offset Offset from the start of the TIFF header of the makernote buffer (not used). @return An auto-pointer to a newly created empty MakerNote. The caller owns this copy and the auto-pointer ensures that it will be deleted. */ MakerNote::AutoPtr createNikonMakerNote(bool alloc, const byte* buf, long len, ByteOrder byteOrder, long offset); // ***************************************************************************** // class definitions //! A MakerNote format used by Nikon cameras, such as the E990 and D1. class Nikon1MakerNote : public IfdMakerNote { public: //! Shortcut for a %Nikon1MakerNote auto pointer. typedef std::auto_ptr AutoPtr; //! @name Creators //@{ /*! @brief Constructor. Allows to choose whether or not memory management is required for the makernote entries. */ Nikon1MakerNote(bool alloc =true); //! Copy constructor Nikon1MakerNote(const Nikon1MakerNote& rhs); //! Virtual destructor virtual ~Nikon1MakerNote() {} //@} //! @name Accessors //@{ AutoPtr create(bool alloc =true) const; AutoPtr clone() const; //! Return read-only list of built-in Nikon1 tags static const TagInfo* tagList(); //@} //! @name Print functions for Nikon1 %MakerNote tags //@{ //! Print ISO setting static std::ostream& print0x0002(std::ostream& os, const Value& value); //! Print autofocus mode static std::ostream& print0x0007(std::ostream& os, const Value& value); //! Print manual focus distance static std::ostream& print0x0085(std::ostream& os, const Value& value); //! Print digital zoom setting static std::ostream& print0x0086(std::ostream& os, const Value& value); //! Print AF focus position static std::ostream& print0x0088(std::ostream& os, const Value& value); //@} //! @cond IGNORE // Public only so that we can create a static instance struct RegisterMn { RegisterMn(); }; //! @endcond private: //! Internal virtual create function. Nikon1MakerNote* create_(bool alloc =true) const; //! Internal virtual copy constructor. Nikon1MakerNote* clone_() const; //! Tag information static const TagInfo tagInfo_[]; }; // class Nikon1MakerNote static Nikon1MakerNote::RegisterMn registerNikon1MakerNote; /*! @brief A second MakerNote format used by Nikon cameras, including the E700, E800, E900, E900S, E910, E950 */ class Nikon2MakerNote : public IfdMakerNote { public: //! Shortcut for a %Nikon2MakerNote auto pointer. typedef std::auto_ptr AutoPtr; //! @name Creators //@{ /*! @brief Constructor. Allows to choose whether or not memory management is required for the makernote entries. */ Nikon2MakerNote(bool alloc =true); //! Copy constructor Nikon2MakerNote(const Nikon2MakerNote& rhs); //! Virtual destructor virtual ~Nikon2MakerNote() {} //@} //! @name Manipulators //@{ int readHeader(const byte* buf, long len, ByteOrder byteOrder); //@} //! @name Accessors //@{ int checkHeader() const; AutoPtr create(bool alloc =true) const; AutoPtr clone() const; //! Return read-only list of built-in Nikon2 tags static const TagInfo* tagList(); //@} //! @name Print functions for Nikon2 %MakerNote tags //@{ //! Print digital zoom setting static std::ostream& print0x000a(std::ostream& os, const Value& value); //@} //! @cond IGNORE // Public only so that we can create a static instance struct RegisterMn { RegisterMn(); }; //! @endcond private: //! Internal virtual create function. Nikon2MakerNote* create_(bool alloc =true) const; //! Internal virtual copy constructor. Nikon2MakerNote* clone_() const; //! Tag information static const TagInfo tagInfo_[]; }; // class Nikon2MakerNote static Nikon2MakerNote::RegisterMn registerNikon2MakerNote; //! A third MakerNote format used by Nikon cameras, e.g., E5400, SQ, D2H, D70 class Nikon3MakerNote : public IfdMakerNote { public: //! Shortcut for a %Nikon3MakerNote auto pointer. typedef std::auto_ptr AutoPtr; //! @name Creators //@{ /*! @brief Constructor. Allows to choose whether or not memory management is required for the makernote entries. */ Nikon3MakerNote(bool alloc =true); //! Copy constructor Nikon3MakerNote(const Nikon3MakerNote& rhs); //! Virtual destructor virtual ~Nikon3MakerNote() {} //@} //! @name Manipulators //@{ int readHeader(const byte* buf, long len, ByteOrder byteOrder); //@} //! @name Accessors //@{ int checkHeader() const; AutoPtr create(bool alloc =true) const; AutoPtr clone() const; //! Return read-only list of built-in Nikon3 tags static const TagInfo* tagList(); //@} //! @name Print functions for Nikon3 %MakerNote tags //@{ //! Print ISO setting static std::ostream& print0x0002(std::ostream& os, const Value& value); //! Print autofocus mode static std::ostream& print0x0007(std::ostream& os, const Value& value); //! Print lens type static std::ostream& print0x0083(std::ostream& os, const Value& value); //! Print lens information static std::ostream& print0x0084(std::ostream& os, const Value& value); //! Print manual focus distance static std::ostream& print0x0085(std::ostream& os, const Value& value); //! Print digital zoom setting static std::ostream& print0x0086(std::ostream& os, const Value& value); //! Print AF point static std::ostream& print0x0088(std::ostream& os, const Value& value); //! Print number of lens stops static std::ostream& print0x008b(std::ostream& os, const Value& value); //! Print number of lens data static std::ostream& print0x0098(std::ostream& os, const Value& value); //@} //! @cond IGNORE // Public only so that we can create a static instance struct RegisterMn { RegisterMn(); }; //! @endcond private: //! Internal virtual create function. Nikon3MakerNote* create_(bool alloc =true) const; //! Internal virtual copy constructor. Nikon3MakerNote* clone_() const; //! Tag information static const TagInfo tagInfo_[]; }; // class Nikon3MakerNote static Nikon3MakerNote::RegisterMn registerNikon3MakerNote; } // namespace Exiv2 #endif // #ifndef NIKONMN_HPP_