Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

QExifImageHeader Class Reference
[QtBaseModule]

The QExifImageHeader class provides functionality for reading and writing EXIF image headers. More...

    #include <QExifImageHeader>

This class is under development and is subject to change.

List of all members, including inherited members

Public Types

enum ExifExtendedTag { ExifVersion, FlashPixVersion, ColorSpace, ComponentsConfiguration, ..., SubjectDistanceRange }
enum GpsTag { GpsVersionId, GpsLatitudeRef, GpsLatitude, GpsLongitudeRef, ..., GpsDifferential }
enum ImageTag { ImageWidth, ImageLength, BitsPerSample, Compression, ..., Copyright }

Public Functions

QExifImageHeader ()
QExifImageHeader ( const QString & fileName )
~QExifImageHeader ()
QSysInfo::Endian byteOrder () const
void clear ()
bool contains ( ImageTag tag ) const
bool contains ( ExifExtendedTag tag ) const
bool contains ( GpsTag tag ) const
QList<ExifExtendedTag> extendedTags () const
QList<GpsTag> gpsTags () const
QList<ImageTag> imageTags () const
bool loadFromJpeg ( const QString & fileName )
bool loadFromJpeg ( QIODevice * device )
bool read ( QIODevice * device )
void remove ( ImageTag tag )
void remove ( ExifExtendedTag tag )
void remove ( GpsTag tag )
bool saveToJpeg ( const QString & fileName ) const
bool saveToJpeg ( QIODevice * device ) const
void setThumbnail ( const QImage & thumbnail )
void setValue ( ImageTag tag, const QExifValue & value )
void setValue ( ExifExtendedTag tag, const QExifValue & value )
void setValue ( GpsTag tag, const QExifValue & value )
qint64 size () const
QImage thumbnail () const
QExifValue value ( ImageTag tag ) const
QExifValue value ( ExifExtendedTag tag ) const
QExifValue value ( GpsTag tag ) const
qint64 write ( QIODevice * device ) const

Detailed Description

The QExifImageHeader class provides functionality for reading and writing EXIF image headers.

EXIF headers are a collection of properties that describe the image they're embedded in. Each property is identified by a tag of which there are three kinds. Image tags which mostly describe the format (dimensions, resolution, orientation) but also include some descriptive information (description, camera make and model, artist). EXIF extended tags which elaborate on some of the image tags and record the camera settings at time of capture among other things. Finally there are GPS tags which record the location the image was captured.

EXIF tags are typically found in JPEG images but may be found in other image formats. To read headers from a JPEG image QExifImageHeader provides the loadFromJpeg() function, and the complementary saveToJpeg() function for writing. To allow reading and writing arbitrary formats QExifImageHeader provides the read() and write() functions which work with just the EXIF header data itself.

Member Type Documentation

enum QExifImageHeader::ExifExtendedTag

Enumerates the extended EXIF tag IDs defined in the EXIF specification.

Constant	Value
`QExifImageHeader::ExifVersion`	`0x9000`
`QExifImageHeader::FlashPixVersion`	`0xA000`
`QExifImageHeader::ColorSpace`	`0xA001`
`QExifImageHeader::ComponentsConfiguration`	`0x9101`
`QExifImageHeader::CompressedBitsPerPixel`	`0x9102`
`QExifImageHeader::PixelXDimension`	`0xA002`
`QExifImageHeader::PixelYDimension`	`0xA003`
`QExifImageHeader::MakerNote`	`0x927C`
`QExifImageHeader::UserComment`	`0x9286`
`QExifImageHeader::RelatedSoundFile`	`0xA004`
`QExifImageHeader::DateTimeOriginal`	`0x9003`
`QExifImageHeader::DateTimeDigitized`	`0x9004`
`QExifImageHeader::SubSecTime`	`0x9290`
`QExifImageHeader::SubSecTimeOriginal`	`0x9291`
`QExifImageHeader::SubSecTimeDigitized`	`0x9292`
`QExifImageHeader::ImageUniqueId`	`0xA420`
`QExifImageHeader::ExposureTime`	`0x829A`
`QExifImageHeader::FNumber`	`0x829D`
`QExifImageHeader::ExposureProgram`	`0x8822`
`QExifImageHeader::SpectralSensitivity`	`0x8824`
`QExifImageHeader::ISOSpeedRatings`	`0x8827`
`QExifImageHeader::Oecf`	`0x8828`
`QExifImageHeader::ShutterSpeedValue`	`0x9201`
`QExifImageHeader::ApertureValue`	`0x9202`
`QExifImageHeader::BrightnessValue`	`0x9203`
`QExifImageHeader::ExposureBiasValue`	`0x9204`
`QExifImageHeader::MaxApertureValue`	`0x9205`
`QExifImageHeader::SubjectDistance`	`0x9206`
`QExifImageHeader::MeteringMode`	`0x9207`
`QExifImageHeader::LightSource`	`0x9208`
`QExifImageHeader::Flash`	`0x9209`
`QExifImageHeader::FocalLength`	`0x920A`
`QExifImageHeader::SubjectArea`	`0x9214`
`QExifImageHeader::FlashEnergy`	`0xA20B`
`QExifImageHeader::SpatialFrequencyResponse`	`0xA20C`
`QExifImageHeader::FocalPlaneXResolution`	`0xA20E`
`QExifImageHeader::FocalPlaneYResolution`	`0xA20F`
`QExifImageHeader::FocalPlaneResolutionUnit`	`0xA210`
`QExifImageHeader::SubjectLocation`	`0xA214`
`QExifImageHeader::ExposureIndex`	`0xA215`
`QExifImageHeader::SensingMethod`	`0xA217`
`QExifImageHeader::FileSource`	`0xA300`
`QExifImageHeader::SceneType`	`0xA301`
`QExifImageHeader::CfaPattern`	`0xA302`
`QExifImageHeader::CustomRendered`	`0xA401`
`QExifImageHeader::ExposureMode`	`0xA402`
`QExifImageHeader::WhiteBalance`	`0xA403`
`QExifImageHeader::DigitalZoomRatio`	`0xA404`
`QExifImageHeader::FocalLengthIn35mmFilm`	`0xA405`
`QExifImageHeader::SceneCaptureType`	`0xA406`
`QExifImageHeader::GainControl`	`0xA407`
`QExifImageHeader::Contrast`	`0xA408`
`QExifImageHeader::Saturation`	`0xA409`
`QExifImageHeader::Sharpness`	`0xA40A`
`QExifImageHeader::DeviceSettingDescription`	`0xA40B`
`QExifImageHeader::SubjectDistanceRange`	`0x40C`

enum QExifImageHeader::GpsTag

Enumerates the GPS tag IDs from the EXIF specification.

Constant	Value
`QExifImageHeader::GpsVersionId`	`0x0000`
`QExifImageHeader::GpsLatitudeRef`	`0x0001`
`QExifImageHeader::GpsLatitude`	`0x0002`
`QExifImageHeader::GpsLongitudeRef`	`0x0003`
`QExifImageHeader::GpsLongitude`	`0x0004`
`QExifImageHeader::GpsAltitudeRef`	`0x0005`
`QExifImageHeader::GpsAltitude`	`0x0006`
`QExifImageHeader::GpsTimeStamp`	`0x0007`
`QExifImageHeader::GpsSatellites`	`0x0008`
`QExifImageHeader::GpsStatus`	`0x0009`
`QExifImageHeader::GpsMeasureMode`	`0x000A`
`QExifImageHeader::GpsDop`	`0x000B`
`QExifImageHeader::GpsSpeedRef`	`0x000C`
`QExifImageHeader::GpsSpeed`	`0x000D`
`QExifImageHeader::GpsTrackRef`	`0x000E`
`QExifImageHeader::GpsTrack`	`0x000F`
`QExifImageHeader::GpsImageDirectionRef`	`0x0010`
`QExifImageHeader::GpsImageDirection`	`0x0011`
`QExifImageHeader::GpsMapDatum`	`0x0012`
`QExifImageHeader::GpsDestLatitudeRef`	`0x0013`
`QExifImageHeader::GpsDestLatitude`	`0x0014`
`QExifImageHeader::GpsDestLongitudeRef`	`0x0015`
`QExifImageHeader::GpsDestLongitude`	`0x0016`
`QExifImageHeader::GpsDestBearingRef`	`0x0017`
`QExifImageHeader::GpsDestBearing`	`0x0018`
`QExifImageHeader::GpsDestDistanceRef`	`0x0019`
`QExifImageHeader::GpsDestDistance`	`0x001A`
`QExifImageHeader::GpsProcessingMethod`	`0x001B`
`QExifImageHeader::GpsAreaInformation`	`0x001C`
`QExifImageHeader::GpsDateStamp`	`0x001D`
`QExifImageHeader::GpsDifferential`	`0x001E`

enum QExifImageHeader::ImageTag

Enumerates the TIFF image tag IDs defined in the EXIF specification.

Constant	Value
`QExifImageHeader::ImageWidth`	`0x0100`
`QExifImageHeader::ImageLength`	`0x0101`
`QExifImageHeader::BitsPerSample`	`0x0102`
`QExifImageHeader::Compression`	`0x0103`
`QExifImageHeader::PhotometricInterpretation`	`0x0106`
`QExifImageHeader::Orientation`	`0x0112`
`QExifImageHeader::SamplesPerPixel`	`0x0115`
`QExifImageHeader::PlanarConfiguration`	`0x011C`
`QExifImageHeader::YCbCrSubSampling`	`0x0212`
`QExifImageHeader::XResolution`	`0x011A`
`QExifImageHeader::YResolution`	`0x011B`
`QExifImageHeader::ResolutionUnit`	`0x0128`
`QExifImageHeader::StripOffsets`	`0x0111`
`QExifImageHeader::RowsPerStrip`	`0x0116`
`QExifImageHeader::StripByteCounts`	`0x0117`
`QExifImageHeader::TransferFunction`	`0x012D`
`QExifImageHeader::WhitePoint`	`0x013E`
`QExifImageHeader::PrimaryChromaciticies`	`0x013F`
`QExifImageHeader::YCbCrCoefficients`	`0x0211`
`QExifImageHeader::ReferenceBlackWhite`	`0x0214`
`QExifImageHeader::DateTime`	`0x0132`
`QExifImageHeader::ImageDescription`	`0x010E`
`QExifImageHeader::Make`	`0x010F`
`QExifImageHeader::Model`	`0x0110`
`QExifImageHeader::Software`	`0x0131`
`QExifImageHeader::Artist`	`0x013B`
`QExifImageHeader::Copyright`	`0x8298`

Member Function Documentation

QExifImageHeader::QExifImageHeader ()

Constructs a new EXIF image data editor.

QExifImageHeader::QExifImageHeader ( const QString & fileName )

Constructs a new EXIF image data editor and reads the meta-data from a JPEG image with the given fileName.

QExifImageHeader::~QExifImageHeader ()

Destroys an EXIF image data editor.

QSysInfo::Endian QExifImageHeader::byteOrder () const

Returns the byte order of EXIF file.

void QExifImageHeader::clear ()

Clears all image meta-data.

bool QExifImageHeader::contains ( ImageTag tag ) const

Returns true if an EXIf header contains a value for an image tag and false otherwise.

bool QExifImageHeader::contains ( ExifExtendedTag tag ) const

This is an overloaded member function, provided for convenience.

Returns true if a header contains a a value for an extended EXIF tag and false otherwise.

bool QExifImageHeader::contains ( GpsTag tag ) const

This is an overloaded member function, provided for convenience.

Returns true if an EXIf header contains a value for a GPS tag and false otherwise.

QList<ExifExtendedTag> QExifImageHeader::extendedTags () const

Returns a list of all extended EXIF tags in a header.

QList<GpsTag> QExifImageHeader::gpsTags () const

Returns a list of all GPS tags in an EXIF header.

QList<ImageTag> QExifImageHeader::imageTags () const

Returns a list of all image tags in an EXIF header.

bool QExifImageHeader::loadFromJpeg ( const QString & fileName )

Reads meta-data from a JPEG image with the given fileName.

Returns true if the data was successfully parsed and false otherwise.

bool QExifImageHeader::loadFromJpeg ( QIODevice * device )

This is an overloaded member function, provided for convenience.

Reads meta-data from an I/O device containing a JPEG image.

Returns true if the data was successfully parsed and false otherwise.

bool QExifImageHeader::read ( QIODevice * device )

Reads the contents of an EXIF header from an I/O device.

Returns true if the header was read and false otherwise.

void QExifImageHeader::remove ( ImageTag tag )

Removes the value for an image tag.

void QExifImageHeader::remove ( ExifExtendedTag tag )

This is an overloaded member function, provided for convenience.

Removes the value for an extended EXIF tag.

void QExifImageHeader::remove ( GpsTag tag )

This is an overloaded member function, provided for convenience.

Removes the value for a GPS tag.

bool QExifImageHeader::saveToJpeg ( const QString & fileName ) const

Saves meta-data to a JPEG image with the given fileName.

Returns true if the data was successfully written.

bool QExifImageHeader::saveToJpeg ( QIODevice * device ) const

This is an overloaded member function, provided for convenience.

Save meta-data to the given I/O device.

The device must be non-sequential and already contain a valid JPEG image.

Returns true if the data was successfully written.

void QExifImageHeader::setThumbnail ( const QImage & thumbnail )

Sets the image thumbnail.

void QExifImageHeader::setValue ( ImageTag tag, const QExifValue & value )

Sets the value for an image tag.

void QExifImageHeader::setValue ( ExifExtendedTag tag, const QExifValue & value )

This is an overloaded member function, provided for convenience.

Sets the value for an extended EXIF tag.

void QExifImageHeader::setValue ( GpsTag tag, const QExifValue & value )

This is an overloaded member function, provided for convenience.

Sets the value for an GPS tag.

qint64 QExifImageHeader::size () const

Returns the size of EXIF data in bytes.

QImage QExifImageHeader::thumbnail () const

Returns the image thumbnail.

QExifValue QExifImageHeader::value ( ImageTag tag ) const

Returns the value for an image tag.

QExifValue QExifImageHeader::value ( ExifExtendedTag tag ) const

This is an overloaded member function, provided for convenience.

Returns the value for an extended EXIF tag.

QExifValue QExifImageHeader::value ( GpsTag tag ) const

This is an overloaded member function, provided for convenience.

Returns the value for a GPS tag.

qint64 QExifImageHeader::write ( QIODevice * device ) const

Writes an EXIF header to an I/O device.

Returns the total number of bytes written.

Trademarks

Qt Extended 4.4.3

QExifImageHeader Class Reference[QtBaseModule]

Public Types

Public Functions

Detailed Description

Member Type Documentation

enum QExifImageHeader::ExifExtendedTag

enum QExifImageHeader::GpsTag

enum QExifImageHeader::ImageTag

Member Function Documentation

QExifImageHeader::QExifImageHeader ()

QExifImageHeader::QExifImageHeader ( const QString & fileName )

QExifImageHeader::~QExifImageHeader ()

QSysInfo::Endian QExifImageHeader::byteOrder () const

void QExifImageHeader::clear ()

bool QExifImageHeader::contains ( ImageTag tag ) const

bool QExifImageHeader::contains ( ExifExtendedTag tag ) const

bool QExifImageHeader::contains ( GpsTag tag ) const

QList<ExifExtendedTag> QExifImageHeader::extendedTags () const

QList<GpsTag> QExifImageHeader::gpsTags () const

QList<ImageTag> QExifImageHeader::imageTags () const

bool QExifImageHeader::loadFromJpeg ( const QString & fileName )

bool QExifImageHeader::loadFromJpeg ( QIODevice * device )

bool QExifImageHeader::read ( QIODevice * device )

void QExifImageHeader::remove ( ImageTag tag )

void QExifImageHeader::remove ( ExifExtendedTag tag )

void QExifImageHeader::remove ( GpsTag tag )

bool QExifImageHeader::saveToJpeg ( const QString & fileName ) const

bool QExifImageHeader::saveToJpeg ( QIODevice * device ) const

void QExifImageHeader::setThumbnail ( const QImage & thumbnail )

void QExifImageHeader::setValue ( ImageTag tag, const QExifValue & value )

void QExifImageHeader::setValue ( ExifExtendedTag tag, const QExifValue & value )

void QExifImageHeader::setValue ( GpsTag tag, const QExifValue & value )

qint64 QExifImageHeader::size () const

QImage QExifImageHeader::thumbnail () const

QExifValue QExifImageHeader::value ( ImageTag tag ) const

QExifValue QExifImageHeader::value ( ExifExtendedTag tag ) const

QExifValue QExifImageHeader::value ( GpsTag tag ) const

qint64 QExifImageHeader::write ( QIODevice * device ) const

QExifImageHeader Class Reference
[QtBaseModule]