mirror of
https://github.com/opencv/opencv.git
synced 2024-12-15 01:39:10 +08:00
9e054d3880
autorotate in-memory jpegs (#8492) * autorotate in-memory jpegs * correct indentation (4 spaces) * imgcodecs: don't apply EXIF rotation for unloaded images * videoio: don't try to rotate MJPEG stream * imgcodecs: ByteStreamBuffer::seekoff support all seek "dir" * imgcodecs: fix condition: "off == egptr() - eback()" is valid offset
254 lines
9.2 KiB
C++
254 lines
9.2 KiB
C++
/*M///////////////////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// IMPORTANT: READ BEFORE DOWNLOADING, COPYING, INSTALLING OR USING.
|
|
//
|
|
// By downloading, copying, installing or using the software you agree to this license.
|
|
// If you do not agree to this license, do not download, install,
|
|
// copy or use the software.
|
|
//
|
|
//
|
|
// License Agreement
|
|
// For Open Source Computer Vision Library
|
|
//
|
|
// Copyright (C) 2000-2008, Intel Corporation, all rights reserved.
|
|
// Copyright (C) 2009, Willow Garage Inc., all rights reserved.
|
|
// Third party copyrights are property of their respective owners.
|
|
//
|
|
// Redistribution and use in source and binary forms, with or without modification,
|
|
// are permitted provided that the following conditions are met:
|
|
//
|
|
// * Redistribution's of source code must retain the above copyright notice,
|
|
// this list of conditions and the following disclaimer.
|
|
//
|
|
// * Redistribution's in binary form must reproduce the above copyright notice,
|
|
// this list of conditions and the following disclaimer in the documentation
|
|
// and/or other materials provided with the distribution.
|
|
//
|
|
// * The name of the copyright holders may not be used to endorse or promote products
|
|
// derived from this software without specific prior written permission.
|
|
//
|
|
// This software is provided by the copyright holders and contributors "as is" and
|
|
// any express or implied warranties, including, but not limited to, the implied
|
|
// warranties of merchantability and fitness for a particular purpose are disclaimed.
|
|
// In no event shall the Intel Corporation or contributors be liable for any direct,
|
|
// indirect, incidental, special, exemplary, or consequential damages
|
|
// (including, but not limited to, procurement of substitute goods or services;
|
|
// loss of use, data, or profits; or business interruption) however caused
|
|
// and on any theory of liability, whether in contract, strict liability,
|
|
// or tort (including negligence or otherwise) arising in any way out of
|
|
// the use of this software, even if advised of the possibility of such damage.
|
|
//
|
|
//M*/
|
|
|
|
|
|
#ifndef _OPENCV_EXIF_HPP_
|
|
#define _OPENCV_EXIF_HPP_
|
|
|
|
#include <cstdio>
|
|
#include <map>
|
|
#include <utility>
|
|
#include <algorithm>
|
|
#include <stdint.h>
|
|
#include <string>
|
|
#include <vector>
|
|
#include <iostream>
|
|
|
|
namespace cv
|
|
{
|
|
/**
|
|
* @brief Jpeg markers that can encounter in Jpeg file
|
|
*/
|
|
enum AppMarkerTypes
|
|
{
|
|
SOI = 0xD8, SOF0 = 0xC0, SOF2 = 0xC2, DHT = 0xC4,
|
|
DQT = 0xDB, DRI = 0xDD, SOS = 0xDA,
|
|
|
|
RST0 = 0xD0, RST1 = 0xD1, RST2 = 0xD2, RST3 = 0xD3,
|
|
RST4 = 0xD4, RST5 = 0xD5, RST6 = 0xD6, RST7 = 0xD7,
|
|
|
|
APP0 = 0xE0, APP1 = 0xE1, APP2 = 0xE2, APP3 = 0xE3,
|
|
APP4 = 0xE4, APP5 = 0xE5, APP6 = 0xE6, APP7 = 0xE7,
|
|
APP8 = 0xE8, APP9 = 0xE9, APP10 = 0xEA, APP11 = 0xEB,
|
|
APP12 = 0xEC, APP13 = 0xED, APP14 = 0xEE, APP15 = 0xEF,
|
|
|
|
COM = 0xFE, EOI = 0xD9
|
|
};
|
|
|
|
/**
|
|
* @brief Base Exif tags used by IFD0 (main image)
|
|
*/
|
|
enum ExifTagName
|
|
{
|
|
IMAGE_DESCRIPTION = 0x010E, ///< Image Description: ASCII string
|
|
MAKE = 0x010F, ///< Description of manufacturer: ASCII string
|
|
MODEL = 0x0110, ///< Description of camera model: ASCII string
|
|
ORIENTATION = 0x0112, ///< Orientation of the image: unsigned short
|
|
XRESOLUTION = 0x011A, ///< Resolution of the image across X axis: unsigned rational
|
|
YRESOLUTION = 0x011B, ///< Resolution of the image across Y axis: unsigned rational
|
|
RESOLUTION_UNIT = 0x0128, ///< Resolution units. '1' no-unit, '2' inch, '3' centimeter
|
|
SOFTWARE = 0x0131, ///< Shows firmware(internal software of digicam) version number
|
|
DATE_TIME = 0x0132, ///< Date/Time of image was last modified
|
|
WHITE_POINT = 0x013E, ///< Chromaticity of white point of the image
|
|
PRIMARY_CHROMATICIES = 0x013F, ///< Chromaticity of the primaries of the image
|
|
Y_CB_CR_COEFFICIENTS = 0x0211, ///< constant to translate an image from YCbCr to RGB format
|
|
Y_CB_CR_POSITIONING = 0x0213, ///< Chroma sample point of subsampling pixel array
|
|
REFERENCE_BLACK_WHITE = 0x0214, ///< Reference value of black point/white point
|
|
COPYRIGHT = 0x8298, ///< Copyright information
|
|
EXIF_OFFSET = 0x8769, ///< Offset to Exif Sub IFD
|
|
INVALID_TAG = 0xFFFF ///< Shows that the tag was not recognized
|
|
};
|
|
|
|
enum Endianess_t
|
|
{
|
|
INTEL = 0x49,
|
|
MOTO = 0x4D,
|
|
NONE = 0x00
|
|
};
|
|
|
|
typedef std::pair<uint32_t, uint32_t> u_rational_t;
|
|
|
|
/**
|
|
* @brief Entry which contains possible values for different exif tags
|
|
*/
|
|
struct ExifEntry_t
|
|
{
|
|
ExifEntry_t();
|
|
|
|
std::vector<u_rational_t> field_u_rational; ///< vector of rational fields
|
|
std::string field_str; ///< any kind of textual information
|
|
|
|
float field_float; ///< Currently is not used
|
|
double field_double; ///< Currently is not used
|
|
|
|
uint32_t field_u32; ///< Unsigned 32-bit value
|
|
int32_t field_s32; ///< Signed 32-bit value
|
|
|
|
uint16_t tag; ///< Tag number
|
|
|
|
uint16_t field_u16; ///< Unsigned 16-bit value
|
|
int16_t field_s16; ///< Signed 16-bit value
|
|
uint8_t field_u8; ///< Unsigned 8-bit value
|
|
int8_t field_s8; ///< Signed 8-bit value
|
|
};
|
|
|
|
/**
|
|
* @brief Picture orientation which may be taken from EXIF
|
|
* Orientation usually matters when the picture is taken by
|
|
* smartphone or other camera with orientation sensor support
|
|
* Corresponds to EXIF 2.3 Specification
|
|
*/
|
|
enum ImageOrientation
|
|
{
|
|
IMAGE_ORIENTATION_TL = 1, ///< Horizontal (normal)
|
|
IMAGE_ORIENTATION_TR = 2, ///< Mirrored horizontal
|
|
IMAGE_ORIENTATION_BR = 3, ///< Rotate 180
|
|
IMAGE_ORIENTATION_BL = 4, ///< Mirrored vertical
|
|
IMAGE_ORIENTATION_LT = 5, ///< Mirrored horizontal & rotate 270 CW
|
|
IMAGE_ORIENTATION_RT = 6, ///< Rotate 90 CW
|
|
IMAGE_ORIENTATION_RB = 7, ///< Mirrored horizontal & rotate 90 CW
|
|
IMAGE_ORIENTATION_LB = 8 ///< Rotate 270 CW
|
|
};
|
|
|
|
/**
|
|
* @brief Reading exif information from Jpeg file
|
|
*
|
|
* Usage example for getting the orientation of the image:
|
|
*
|
|
* @code
|
|
* ExifReader reader(fileName);
|
|
* if( reader.parse() )
|
|
* {
|
|
* int orientation = reader.getTag(Orientation).field_u16;
|
|
* }
|
|
* @endcode
|
|
*
|
|
*/
|
|
class ExifReader
|
|
{
|
|
public:
|
|
/**
|
|
* @brief ExifReader constructor. Constructs an object of exif reader
|
|
*
|
|
* @param [in]stream An istream to look for EXIF bytes from
|
|
*/
|
|
explicit ExifReader( std::istream& stream );
|
|
~ExifReader();
|
|
|
|
|
|
/**
|
|
* @brief Parse the file with exif info
|
|
*
|
|
* @return true if parsing was successful and exif information exists in JpegReader object
|
|
*/
|
|
bool parse();
|
|
|
|
/**
|
|
* @brief Get tag info by tag number
|
|
*
|
|
* @param [in] tag The tag number
|
|
* @return ExifEntru_t structure. Caller has to know what tag it calls in order to extract proper field from the structure ExifEntry_t
|
|
*/
|
|
ExifEntry_t getTag( const ExifTagName tag );
|
|
|
|
private:
|
|
std::istream& m_stream;
|
|
std::vector<unsigned char> m_data;
|
|
std::map<int, ExifEntry_t > m_exif;
|
|
Endianess_t m_format;
|
|
|
|
void parseExif();
|
|
bool checkTagMark() const;
|
|
|
|
size_t getFieldSize ();
|
|
size_t getNumDirEntry() const;
|
|
uint32_t getStartOffset() const;
|
|
uint16_t getExifTag( const size_t offset ) const;
|
|
uint16_t getU16( const size_t offset ) const;
|
|
uint32_t getU32( const size_t offset ) const;
|
|
uint16_t getOrientation( const size_t offset ) const;
|
|
uint16_t getResolutionUnit( const size_t offset ) const;
|
|
uint16_t getYCbCrPos( const size_t offset ) const;
|
|
|
|
Endianess_t getFormat() const;
|
|
|
|
ExifEntry_t parseExifEntry( const size_t offset );
|
|
|
|
u_rational_t getURational( const size_t offset ) const;
|
|
|
|
std::map<int, ExifEntry_t > getExif();
|
|
std::string getString( const size_t offset ) const;
|
|
std::vector<u_rational_t> getResolution( const size_t offset ) const;
|
|
std::vector<u_rational_t> getWhitePoint( const size_t offset ) const;
|
|
std::vector<u_rational_t> getPrimaryChromaticies( const size_t offset ) const;
|
|
std::vector<u_rational_t> getYCbCrCoeffs( const size_t offset ) const;
|
|
std::vector<u_rational_t> getRefBW( const size_t offset ) const;
|
|
|
|
private:
|
|
static const uint16_t tagMarkRequired = 0x2A;
|
|
|
|
//offset to the _number-of-directory-entry_ field
|
|
static const size_t offsetNumDir = 8;
|
|
|
|
//max size of data in tag.
|
|
//'DDDDDDDD' contains the value of that Tag. If its size is over 4bytes,
|
|
//'DDDDDDDD' contains the offset to data stored address.
|
|
static const size_t maxDataSize = 4;
|
|
|
|
//bytes per tag field
|
|
static const size_t tiffFieldSize = 12;
|
|
|
|
//number of primary chromaticies components
|
|
static const size_t primaryChromaticiesComponents = 6;
|
|
|
|
//number of YCbCr coefficients in field
|
|
static const size_t ycbcrCoeffs = 3;
|
|
|
|
//number of Reference Black&White components
|
|
static const size_t refBWComponents = 6;
|
|
};
|
|
|
|
|
|
}
|
|
|
|
#endif /* _OPENCV_EXIF_HPP_ */
|