CExifModify Class Reference

API published in: S60 3rd Ed

Link against: exiflib.lib

Capability Information

Required Capabilities

None

#include <exifmodify.h>

Detailed Description

CExifModify Interface class for modifying existing Exif v2.2 (or prior) file format or creating Exif v2.2 file format using valid Jpeg image.

An instance of this class can be instantiated in one of two ways: by providing valid Exif data or by providing valid Jpeg image.


Public Types
enum	TOperationMode { EModify = 0, ECreate }
	The operation mode enumeration specifying the create or modify modes. More...
enum	TExifModifyOption { ENoOptions = 0x0000, ENoJpegParsing = 0x0001 }
Public Member Functions
virtual	~CExifModify ()
	Destructor.
virtual const CExifRead *	Reader () const =0
	Returns a constant pointer to a CExifRead instance that can be used to parse the associated Exif image.
virtual void	SetTagL (TExifIfdType aIfdType, TExifTagInfo aExifTagInfo, const TDesC8 &aTagData)=0
	Inserts/Updates the given tag in the specified IFD structure of the Exif data.
virtual TInt	DeleteTag (TExifIfdType aIfdType, TUint16 aTagId)=0
	Removes the tag with the given tag ID from the specified IFD structure in the Exif data.
virtual TInt	DeleteIfd (TExifIfdType aIfdType)=0
	Removes the specified IFD structure and all its tags from the Exif data.
virtual void	SetThumbnailL (const TDesC8 &aThumbnailData)=0
	Inserts/Updates the given thumbnail Jpeg image data into the 1st IFD structure in the Exif data.
virtual TInt	RemoveThumbnail ()=0
	Removes the thumbnail Jpeg image data from the 1st IFD structure in the Exif data.
virtual HBufC8 *	WriteDataL (const TDesC8 &aInData)=0
	Flushes the Exif data into the given data buffer, and releases the internal structures.
virtual void	SetImageDescriptionL (const TDesC8 &aImageDescription)=0
	Inserts/Updates given Image Description in the Exif data.
virtual void	SetMakeL (const TDesC8 &aMake)=0
	Inserts/Updates given Make in the Exif data.
virtual void	SetModelL (const TDesC8 &aModel)=0
	Inserts/Updates given Model in the Exif data.
virtual void	SetOrientationL (TUint16 aOrientation)=0
	Inserts/Updates given Orientation in the Exif data.
virtual void	SetXResolutionL (TUint32 aXResolution1, TUint32 aXResolution2)=0
	Inserts/Updates given X Resolution in the Exif data.
virtual void	SetYResolutionL (TUint32 aYResolution1, TUint32 aYResolution2)=0
	Inserts/Updates given Y Resolution in the Exif data.
virtual void	SetResolutionUnitL (TUint16 aResolutionUnit)=0
	Inserts/Updates given Resolution Unit in the Exif data.
virtual void	SetTransferFunctionL (const TDesC8 &aTransferFunction)=0
	Inserts/Updates given Transfer Function in the Exif data.
virtual void	SetDateTimeL (const TDesC8 &aDateTime)=0
	Inserts/Updates given Date Time in the Exif data.
virtual void	SetYCbCrPositioningL (TUint16 aYCbCrPositioning)=0
	Inserts/Updates given YCbCr Positioning in the Exif data.
virtual void	SetSoftwareL (const TDesC8 &aSoftware)=0
	Inserts/Updates given Software in the Exif data.
virtual void	SetCopyrightL (const TDesC8 &aCopyright)=0
	Inserts/Updates given Copyright in the Exif data.
virtual void	SetExposureTimeL (TUint32 aExposureTime1, TUint32 aExposureTime2)=0
	Inserts/Updates given Exposure Time in the Exif data.
virtual void	SetComponentsConfigurationL (TUint8 aFirstComponent, TUint8 aSecondComponent, TUint8 aThirdComponent, TUint8 aFourthComponent)=0
	Inserts/Updates given Components Configuration in the Exif data.
virtual void	SetFlashL (TUint16 aFlash)=0
	Inserts/Updates given Flash in the Exif data.
virtual void	SetColorSpaceL (TUint16 aColorSpace)=0
	Inserts/Updates given Color Space in the Exif data.
virtual void	SetPixelXDimensionL (TUint32 aPixelXDimension)=0
	Inserts/Updates given Pixel X Dimension in the Exif data.
virtual void	SetPixelYDimensionL (TUint32 aPixelYDimension)=0
	Inserts/Updates given Pixel Y Dimension in the Exif data.
virtual void	SetExposureModeL (TUint16 aExposureMode)=0
	Inserts/Updates given Exposure Mode in the Exif data.
virtual void	SetWhiteBalanceL (TUint16 aWhiteBalance)=0
	Inserts/Updates given White Balance in the Exif data.
virtual void	SetSceneCaptureTypeL (TUint16 aSceneCaptureType)=0
	Inserts/Updates given Scene Capture Type in the Exif data.
virtual void	SetExposureProgramL (TUint16 aExposureProgram)=0
	Inserts/Updates given Exposure Program in the Exif data.
virtual void	SetIsoSpeedRatingsL (const TDesC8 &aIsoSpeedRatings)=0
	Inserts/Updates given Iso Speed Ratings in the Exif data.
virtual void	SetDateTimeOriginalL (const TDesC8 &aDateTimeOriginal)=0
	Inserts/Updates given Date Time Original in the Exif data.
virtual void	SetDateTimeDigitizedL (const TDesC8 &aDateTimeDigitized)=0
	Inserts/Updates given Date Time Digitized in the Exif data.
virtual void	SetApertureValueL (TUint32 aApertureValue1, TUint32 aApertureValue2)=0
	Inserts/Updates given Aperture Value in the Exif data.
virtual void	SetExposureBiasValueL (TInt32 aExposureBiasValue1, TInt32 aExposureBiasValue2)=0
	Inserts/Updates given Exposure Bias Value in the Exif data.
virtual void	SetMeteringModeL (TUint16 aMeteringMode)=0
	Inserts/Updates given Metering Mode in the Exif data.
virtual void	SetLightSourceL (TUint16 aLightSource)=0
	Inserts/Updates given Light Source in the Exif data.
virtual void	SetMakerNoteL (const TDesC8 &aMakerNote)=0
	Inserts/Updates given Maker Note in the Exif data.
virtual void	SetUserCommentL (const TDesC8 &aUserComment)=0
	Inserts/Updates given User Comment in the Exif data.
virtual void	SetRelatedSoundFileL (const TDesC8 &aRelatedSoundFile)=0
	Inserts/Updates given Related Sound File in the Exif data.
virtual void	SetFileSourceL (TInt8 aFileSource)=0
	Inserts/Updates given File Source in the Exif data.
virtual void	SetDigitalZoomRatioL (TUint32 aDigitalZoomRatio1, TUint32 aDigitalZoomRatio2)=0
	Inserts/Updates given Digital Zoom Ratio in the Exif data.
virtual void	SetContrastL (TUint16 aContrast)=0
	Inserts/Updates given Contrast in the Exif data.
virtual void	SetSaturationL (TUint16 aSaturation)=0
	Inserts/Updates given Saturation in the Exif data.
virtual void	SetSharpnessL (TUint16 aSharpness)=0
	Inserts/Updates given Sharpness in the Exif data.
virtual void	SetThumbnailXResolutionL (TUint32 aXResolution1, TUint32 aXResolution2)=0
	Inserts/Updates given thumbnail X Resolution in the Exif data.
virtual void	SetThumbnailYResolutionL (TUint32 aYResolution1, TUint32 aYResolution2)=0
	Inserts/Updates given thumbnail Y Resolution in the Exif data.
virtual void	SetThumbnailResolutionUnitL (TUint16 aResolutionUnit)=0
	Inserts/Updates given thumbnail Resolution Unit in the Exif data.
virtual void	SetShutterSpeedValueL (TInt32 aShutterSpeedValue1, TInt32 aShutterSpeedValue2)=0
	Inserts/Updates given Shutter Speed Value in the Exif data.
virtual void	SetBrightnessValueL (TInt32 aBrightnessValue1, TInt32 aBrightnessValue2)=0
	Inserts/Updates given Brightness Value in the Exif data.
virtual void	SetCustomRenderedL (TUint16 aCustomRendered)=0
	Inserts/Updates given Custom Rendered in the Exif data.
virtual void	SetGainControlL (TUint16 aGainControl)=0
	Inserts/Updates given Gain Control in the Exif data.
Static Public Member Functions
static IMPORT_C CExifModify *	NewL (const TDesC8 &aInData, CExifModify::TOperationMode aOperationMode=EModify)
	Two-phased constructor.
static IMPORT_C CExifModify *	NewL (const TDesC8 &aInData, CExifModify::TOperationMode aOperationMode, TUint aExifModifyOption)
static IMPORT_C CExifModify *	NewL ()
	Two-phased constructor.

Member Enumeration Documentation

enum CExifModify::TExifModifyOption

Enumerator:

ENoOptions
ENoJpegParsing

enum CExifModify::TOperationMode

The operation mode enumeration specifying the create or modify modes.

Enumerator:

EModify
ECreate

Constructor & Destructor Documentation

virtual CExifModify::~CExifModify ( ) [virtual]

Destructor.

Member Function Documentation

virtual TInt CExifModify::DeleteIfd ( TExifIfdType aIfdType ) [pure virtual]

Removes the specified IFD structure and all its tags from the Exif data.

Parameters:

aIfdType

The target IFD type.

Returns:: Error code.

virtual TInt CExifModify::DeleteTag	(	TExifIfdType	aIfdType,
		TUint16	aTagId
	)	`[pure virtual]`

Removes the tag with the given tag ID from the specified IFD structure in the Exif data.

Parameters:

	aIfdType	The hosting IFD type.
	aTagId	The target tag ID.

Returns:: Error code.

static IMPORT_C CExifModify* CExifModify::NewL ( ) [static]

Two-phased constructor.

static IMPORT_C CExifModify* CExifModify::NewL	(	const TDesC8 &	aInData,
		CExifModify::TOperationMode	aOperationMode,
		TUint	aExifModifyOption
	)	`[static]`

static IMPORT_C CExifModify* CExifModify::NewL	(	const TDesC8 &	aInData,
		CExifModify::TOperationMode	aOperationMode = `EModify`
	)	`[static]`

Two-phased constructor.

virtual const CExifRead* CExifModify::Reader ( ) const [pure virtual]

Returns a constant pointer to a CExifRead instance that can be used to parse the associated Exif image.

Returns:: Unmodifiable pointer to Exif reader instance.

virtual TInt CExifModify::RemoveThumbnail ( ) [pure virtual]

Removes the thumbnail Jpeg image data from the 1st IFD structure in the Exif data.

Returns:: Error code.

virtual void CExifModify::SetApertureValueL	(	TUint32	aApertureValue1,
		TUint32	aApertureValue2
	)	`[pure virtual]`

Inserts/Updates given Aperture Value in the Exif data.

Parameters:

	aApertureValue1	Updated Aperture Value numerator.
	aApertureValue2	Updated Aperture Value denominator.

Returns:: void

virtual void CExifModify::SetBrightnessValueL	(	TInt32	aBrightnessValue1,
		TInt32	aBrightnessValue2
	)	`[pure virtual]`

Inserts/Updates given Brightness Value in the Exif data.

Parameters:

	aBrightnessValue1	Updated Brightness Value numerator.
	aBrightnessValue2	Updated Brightness Value denominator.

Returns:: void

virtual void CExifModify::SetColorSpaceL ( TUint16 aColorSpace ) [pure virtual]

Inserts/Updates given Color Space in the Exif data.

Parameters:

aColorSpace

Updated Color Space data.

Returns:: void

virtual void CExifModify::SetComponentsConfigurationL	(	TUint8	aFirstComponent,
		TUint8	aSecondComponent,
		TUint8	aThirdComponent,
		TUint8	aFourthComponent
	)	`[pure virtual]`

Inserts/Updates given Components Configuration in the Exif data.

Parameters:

aComponentsConfiguration

Updated Components Configuration data.

Returns:: void

virtual void CExifModify::SetContrastL ( TUint16 aContrast ) [pure virtual]

Inserts/Updates given Contrast in the Exif data.

Parameters:

aContrast

Updated Contrast data.

Returns:: void

virtual void CExifModify::SetCopyrightL ( const TDesC8 & aCopyright ) [pure virtual]

Inserts/Updates given Copyright in the Exif data.

Parameters:

aCopyright

Updated Copyright data.

Returns:: void

virtual void CExifModify::SetCustomRenderedL ( TUint16 aCustomRendered ) [pure virtual]

Inserts/Updates given Custom Rendered in the Exif data.

Parameters:

aCustomRendered

Updated Custom Rendered data.

Returns:: void

virtual void CExifModify::SetDateTimeDigitizedL ( const TDesC8 & aDateTimeDigitized ) [pure virtual]

Inserts/Updates given Date Time Digitized in the Exif data.

Parameters:

aDateTimeDigitized

Updated Date Time Digitized data.

Returns:: void

virtual void CExifModify::SetDateTimeL ( const TDesC8 & aDateTime ) [pure virtual]

Inserts/Updates given Date Time in the Exif data.

Parameters:

aDateTime

Updated Date Time data.

Returns:: void

virtual void CExifModify::SetDateTimeOriginalL ( const TDesC8 & aDateTimeOriginal ) [pure virtual]

Inserts/Updates given Date Time Original in the Exif data.

Parameters:

aDateTimeOriginal

Updated Date Time Original data.

Returns:: void

virtual void CExifModify::SetDigitalZoomRatioL	(	TUint32	aDigitalZoomRatio1,
		TUint32	aDigitalZoomRatio2
	)	`[pure virtual]`

Inserts/Updates given Digital Zoom Ratio in the Exif data.

Parameters:

	aDigitalZoomRatio1	Updated Digital Zoom Ratio numerator.
	aDigitalZoomRatio2	Updated Digital Zoom Ratio denominator.

Returns:: void

virtual void CExifModify::SetExposureBiasValueL	(	TInt32	aExposureBiasValue1,
		TInt32	aExposureBiasValue2
	)	`[pure virtual]`

Inserts/Updates given Exposure Bias Value in the Exif data.

Parameters:

	aExposureBiasValue1	Updated Exposure Bias Value numerator.
	aExposureBiasValue2	Updated Exposure Bias Value denominator.

Returns:: void

virtual void CExifModify::SetExposureModeL ( TUint16 aExposureMode ) [pure virtual]

Inserts/Updates given Exposure Mode in the Exif data.

Parameters:

aExposureMode

Updated Exposure Mode data.

Returns:: void

virtual void CExifModify::SetExposureProgramL ( TUint16 aExposureProgram ) [pure virtual]

Inserts/Updates given Exposure Program in the Exif data.

Parameters:

aExposureProgram

Updated Exposure Program data.

Returns:: void

virtual void CExifModify::SetExposureTimeL	(	TUint32	aExposureTime1,
		TUint32	aExposureTime2
	)	`[pure virtual]`

Inserts/Updates given Exposure Time in the Exif data.

Parameters:

	aExposureTime1	Updated Exposure Time numerator.
	aExposureTime2	Updated Exposure Time denominator.

Returns:: void

virtual void CExifModify::SetFileSourceL ( TInt8 aFileSource ) [pure virtual]

Inserts/Updates given File Source in the Exif data.

Parameters:

aFileSource

Updated File Source data.

Returns:: void

virtual void CExifModify::SetFlashL ( TUint16 aFlash ) [pure virtual]

Inserts/Updates given Flash in the Exif data.

Parameters:

aFlash

Updated Flash data.

Returns:: void

virtual void CExifModify::SetGainControlL ( TUint16 aGainControl ) [pure virtual]

Inserts/Updates given Gain Control in the Exif data.

Parameters:

aGainControl

Updated Gain Control data.

Returns:: void

virtual void CExifModify::SetImageDescriptionL ( const TDesC8 & aImageDescription ) [pure virtual]

Inserts/Updates given Image Description in the Exif data.

Parameters:

aImageDescription

Updated Image Description data.

Returns:: void

virtual void CExifModify::SetIsoSpeedRatingsL ( const TDesC8 & aIsoSpeedRatings ) [pure virtual]

Inserts/Updates given Iso Speed Ratings in the Exif data.

Parameters:

aIsoSpeedRatings

Updated Iso Speed Ratings data.

Returns:: void

virtual void CExifModify::SetLightSourceL ( TUint16 aLightSource ) [pure virtual]

Inserts/Updates given Light Source in the Exif data.

Parameters:

aLightSource

Updated Light Source data.

Returns:: void

virtual void CExifModify::SetMakeL ( const TDesC8 & aMake ) [pure virtual]

Inserts/Updates given Make in the Exif data.

Parameters:

aMake

Updated Make data.

Returns:: void

virtual void CExifModify::SetMakerNoteL ( const TDesC8 & aMakerNote ) [pure virtual]

Inserts/Updates given Maker Note in the Exif data.

Parameters:

aMakerNote

Updated Maker Note data.

Returns:: void

virtual void CExifModify::SetMeteringModeL ( TUint16 aMeteringMode ) [pure virtual]

Inserts/Updates given Metering Mode in the Exif data.

Parameters:

aMeteringMode

Updated Metering Mode data.

Returns:: void

virtual void CExifModify::SetModelL ( const TDesC8 & aModel ) [pure virtual]

Inserts/Updates given Model in the Exif data.

Parameters:

aModel

Updated Model data.

Returns:: void

virtual void CExifModify::SetOrientationL ( TUint16 aOrientation ) [pure virtual]

Inserts/Updates given Orientation in the Exif data.

Parameters:

aOrientation

Updated Orientation data.

Returns:: void

virtual void CExifModify::SetPixelXDimensionL ( TUint32 aPixelXDimension ) [pure virtual]

Inserts/Updates given Pixel X Dimension in the Exif data.

Parameters:

aPixelXDimension

Updated Pixel X Dimension data.

Returns:: void

virtual void CExifModify::SetPixelYDimensionL ( TUint32 aPixelYDimension ) [pure virtual]

Inserts/Updates given Pixel Y Dimension in the Exif data.

Parameters:

aPixelYDimension

Updated Pixel Y Dimension data.

Returns:: void

virtual void CExifModify::SetRelatedSoundFileL ( const TDesC8 & aRelatedSoundFile ) [pure virtual]

Inserts/Updates given Related Sound File in the Exif data.

Parameters:

aRelatedSoundFile

Updated Related Sound File data.

Returns:: void

virtual void CExifModify::SetResolutionUnitL ( TUint16 aResolutionUnit ) [pure virtual]

Inserts/Updates given Resolution Unit in the Exif data.

Parameters:

aResolutionUnit

Updated Resolution Unit data.

Returns:: void

virtual void CExifModify::SetSaturationL ( TUint16 aSaturation ) [pure virtual]

Inserts/Updates given Saturation in the Exif data.

Parameters:

aSaturation

Updated Saturation data.

Returns:: void

virtual void CExifModify::SetSceneCaptureTypeL ( TUint16 aSceneCaptureType ) [pure virtual]

Inserts/Updates given Scene Capture Type in the Exif data.

Parameters:

aSceneCaptureType

Updated Scene Capture Type data.

Returns:: void

virtual void CExifModify::SetSharpnessL ( TUint16 aSharpness ) [pure virtual]

Inserts/Updates given Sharpness in the Exif data.

Parameters:

aSharpness

Updated Sharpness data.

Returns:: void

virtual void CExifModify::SetShutterSpeedValueL	(	TInt32	aShutterSpeedValue1,
		TInt32	aShutterSpeedValue2
	)	`[pure virtual]`

Inserts/Updates given Shutter Speed Value in the Exif data.

Parameters:

	aShutterSpeedValue1	Updated Shutter Speed Value numerator.
	aShutterSpeedValue2	Updated Shutter Speed Value denominator.

Returns:: void

virtual void CExifModify::SetSoftwareL ( const TDesC8 & aSoftware ) [pure virtual]

Inserts/Updates given Software in the Exif data.

Parameters:

aSoftware

Updated Software data.

Returns:: void

virtual void CExifModify::SetTagL	(	TExifIfdType	aIfdType,
		TExifTagInfo	aExifTagInfo,
		const TDesC8 &	aTagData
	)	`[pure virtual]`

Inserts/Updates the given tag in the specified IFD structure of the Exif data.

Parameters:

	aIfdType	The hosting IFD type.
	aExifTagInfo	The informative fields of tag that is updated.
	aExifData	Data of the tag that is updated.

Returns:: void

virtual void CExifModify::SetThumbnailL ( const TDesC8 & aThumbnailData ) [pure virtual]

Inserts/Updates the given thumbnail Jpeg image data into the 1st IFD structure in the Exif data.

Parameters:

aThumbnailData

The Exif thumbnail image data that is updated.

Returns:: void

virtual void CExifModify::SetThumbnailResolutionUnitL ( TUint16 aResolutionUnit ) [pure virtual]

Inserts/Updates given thumbnail Resolution Unit in the Exif data.

Parameters:

aResolutionUnit

Updated thumbnail Resolution Unit data.

Returns:: void

virtual void CExifModify::SetThumbnailXResolutionL	(	TUint32	aXResolution1,
		TUint32	aXResolution2
	)	`[pure virtual]`

Inserts/Updates given thumbnail X Resolution in the Exif data.

Parameters:

	aXResolution1	Updated thumbnail X Resolution numerator.
	aXResolution2	Updated thumbnail X Resolution denominator.

Returns:: void

virtual void CExifModify::SetThumbnailYResolutionL	(	TUint32	aYResolution1,
		TUint32	aYResolution2
	)	`[pure virtual]`

Inserts/Updates given thumbnail Y Resolution in the Exif data.

Parameters:

	aYResolution1	Updated thumbnail Y Resolution numerator.
	aYResolution2	Updated thumbnail Y Resolution denominator.

Returns:: void

virtual void CExifModify::SetTransferFunctionL ( const TDesC8 & aTransferFunction ) [pure virtual]

Inserts/Updates given Transfer Function in the Exif data.

Parameters:

aTransferFunction

Updated Transfer Function data.

Returns:: void

virtual void CExifModify::SetUserCommentL ( const TDesC8 & aUserComment ) [pure virtual]

Inserts/Updates given User Comment in the Exif data.

Parameters:

aUserComment

Updated User Comment data.

Returns:: void

virtual void CExifModify::SetWhiteBalanceL ( TUint16 aWhiteBalance ) [pure virtual]

Inserts/Updates given White Balance in the Exif data.

Parameters:

aWhiteBalance

Updated White Balance data.

Returns:: void

virtual void CExifModify::SetXResolutionL	(	TUint32	aXResolution1,
		TUint32	aXResolution2
	)	`[pure virtual]`

Inserts/Updates given X Resolution in the Exif data.

Parameters:

	aXResolution1	Updated X Resolution numerator.
	aXResolution2	Updated X Resolution denominator.

Returns:: void

virtual void CExifModify::SetYCbCrPositioningL ( TUint16 aYCbCrPositioning ) [pure virtual]

Inserts/Updates given YCbCr Positioning in the Exif data.

Parameters:

aYCbCrPositioning

YCbCr Positioning data.

Returns:: void

virtual void CExifModify::SetYResolutionL	(	TUint32	aYResolution1,
		TUint32	aYResolution2
	)	`[pure virtual]`

Inserts/Updates given Y Resolution in the Exif data.

Parameters:

	aYResolution1	Updated Y Resolution numerator.
	aYResolution2	Updated Y Resolution denominator.

Returns:: void

virtual HBufC8* CExifModify::WriteDataL ( const TDesC8 & aInData ) [pure virtual]

Flushes the Exif data into the given data buffer, and releases the internal structures.

Parameters:

aInData

The original Exif image data, which contains identical data provided while calling the NewL function.

Returns:: Pointer to descriptor containing new Exif image data.

The documentation for this class was generated from the following file:

exifmodify.h

CExifModify Class Reference

Capability Information

Detailed Description

Public Types

Public Member Functions

Static Public Member Functions

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation