MExifMetadataWriter Class Reference

#include <iclexif.h>

class MExifMetadataWriter

Public Member Functions
pure virtual TInt	SetIntegerArrayParam(TUint, TUint, CArrayFix< TInt > &)
pure virtual TInt	SetIntegerParam(TUint, TUint, TInt)
pure virtual TInt	SetParam16(TUint, TUint, HBufC16 *)
pure virtual TInt	SetParam8(TUint, TUint, HBufC8 *)
pure virtual TInt	SetRationalArrayParam(TUint, TUint, CArrayFix< TRational > &)
pure virtual TInt	SetRationalParam(TUint, TUint, TInt, TInt)
pure virtual TInt	SetShortArrayParam(TUint, TUint, CArrayFix< TUint16 > &)
pure virtual TInt	SetShortParam(TUint, TUint, TUint16)

Detailed Description

generic accessor to write the tags from exif metadata.

Note: The aIfd argument in MExifMetadataWriter methods should be set as follows:

When writing to an IFD 0 tag that is not a GPS tag, use KExifIfdZero.
When writing to a tag related to thumbnail, use KExifIfdOne.
When writing to a GPS tag, use KExifGpsIfd.

The TExifWriterUtility class offers a friendlier interface to access these tags.

Member Function Documentation

SetIntegerArrayParam ( TUint, TUint, CArrayFix< TInt > & )

TInt	SetIntegerArrayParam	(	TUint	aTag,
			TUint	aIfd,
			CArrayFix< TInt > &	aParam
		)	[pure virtual]

Sets the data associated with an array of signed or unsigned 32-bit integers EXIF/DCF tag/IFD.

Parameters
aTag	the tag id where the data is stored
aIfd	the ifd section in which the tag is stored.
aParam	the list of values value for the tag

Return Value: error code KErrNotSupported if called on a decoding module. KErrNotSupported if the plugin does not support the specified tag. KErrArgument if the requested data type does not match with the tag.

SetIntegerParam ( TUint, TUint, TInt )

TInt	SetIntegerParam	(	TUint	aTag,
			TUint	aIfd,
			TInt	aParam
		)	[pure virtual]

Sets the data associated with a signed or unsigned 32-bit integer EXIF/DCF tag/IFD.

Parameters
aTag	the tag id where the data is stored
aIfd	the ifd section in which the tag is stored.
aParam	the value of the tag

Return Value: error code KErrNotSupported if called on a decoding module. KErrNotSupported if the plugin does not support the specified tag. KErrArgument if the requested data type does not match with the tag.

SetParam16 ( TUint, TUint, HBufC16 * )

TInt	SetParam16	(	TUint	aTag,
			TUint	aIfd,
			HBufC16 *	aParam
		)	[pure virtual]

Set 16-bit Unicode data into EXIF/DCF tag/IFDs that support it (e.g.0x9286 (UserComment), 0x001B (GpsProcessingMethod) or 0x001C (GpsAreaInformation) ).

Note: This method will add the 8-byte prefix "UNICODE/0" to aParam before setting the tag value in the metadata. It may only be used to set Unicode data.

Parameters
aTag	the tag id where the data is stored
aIfd	the ifd section in which the tag is stored.
aParam	the value of the tag

Return Value: error code KErrNotSupported if called on a decoding module. KErrNotSupported if the plugin does not support the specified tag. KErrArgument if the requested data type does not match with the tag.

SetParam8 ( TUint, TUint, HBufC8 * )

TInt	SetParam8	(	TUint	aTag,
			TUint	aIfd,
			HBufC8 *	aParam
		)	[pure virtual]

Set the data associated with an 8-bit (e.g. ASCII, Undefined or Byte) EXIF/DCF tag/IFD.

Note: If setting non-NULL terminated ASCII data, this method will add a NULL terminator to it provided that doing so will not cause the length of the tag value to be exceeded. If the length would be exceeded KErrArgument will be returned.

Note: This method will set other (non-ASCII) 8-bit data exactly as-is.

Parameters
aTag	the tag id where the data is stored
aIfd	the ifd section in which the tag is stored.
aParam	the value of the tag

Return Value: error code KErrNotSupported if called on a decoding module. KErrNotSupported if the plugin does not support the specified tag. KErrArgument if the requested data type does not match with the tag.

SetRationalArrayParam ( TUint, TUint, CArrayFix< TRational > & )

TInt	SetRationalArrayParam	(	TUint	aTag,
			TUint	aIfd,
			CArrayFix< TRational > &	aParam
		)	[pure virtual]

Sets the data associated with an array of signed or unsigned rationals EXIF/DCF tag/IFD.

Parameters
aTag	the tag id where the data is stored
aIfd	the ifd section in which the tag is stored.
aParam	the list of values value for the tag

Return Value: error code KErrNotSupported if called on a decoding module. KErrNotSupported if the plugin does not support the specified tag. KErrArgument if the requested data type does not match with the tag.

SetRationalParam ( TUint, TUint, TInt, TInt )

TInt	SetRationalParam	(	TUint	aTag,
			TUint	aIfd,
			TInt	aNumerator,
			TInt	aDenominator
		)	[pure virtual]

Sets the data associated with a signed or unsigned rational EXIF/DCF tag/IFD.

Parameters
aTag	the tag id where the data is stored
aIfd	the ifd section in which the tag is stored.
aNumerator	the numerator value of the rational tag
aDenominator	the denominator value of the rational tag

Return Value: error code KErrNotSupported if called on a decoding module. KErrNotSupported if the plugin does not support the specified tag. KErrArgument if the requested data type does not match with the tag.

SetShortArrayParam ( TUint, TUint, CArrayFix< TUint16 > & )

TInt	SetShortArrayParam	(	TUint	aTag,
			TUint	aIfd,
			CArrayFix< TUint16 > &	aParam
		)	[pure virtual]

Sets the data associated with an array of unsigned short (16-bit) EXIF/DCF tag/IFD.

Parameters
aTag	the tag id where the data is stored
aIfd	the ifd section in which the tag is stored.
aParam	the list of values value for the tag

Return Value: error code KErrNotSupported if called on a decoding module. KErrNotSupported if the plugin does not support the specified tag. KErrArgument if the requested data type does not match with the tag.

SetShortParam ( TUint, TUint, TUint16 )

TInt	SetShortParam	(	TUint	aTag,
			TUint	aIfd,
			TUint16	aParam
		)	[pure virtual]

Sets the data associated with an unsigned short (16-bit) EXIF/DCF tag/IFD.

Parameters
aTag	the tag id where the data is stored
aIfd	the ifd section in which the tag is stored.
aParam	the value of the tag

Return Value: error code KErrNotSupported if called on a decoding module. KErrNotSupported if the plugin does not support the specified tag. KErrArgument if the requested data type does not match with the tag.