Class MExifMetadataWriter

class MExifMetadataWriter;

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.

Members

Defined in MExifMetadataWriter:
SetIntegerArrayParam(), SetIntegerParam(), SetParam16(), SetParam8(), SetRationalArrayParam(), SetRationalParam(), SetShortArrayParam(), SetShortParam()

See also:

• TExifWriterUtility

virtual TInt SetParam8(TUint aTag, TUint aIfd, HBufC8 *aParam)=0;

Description

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

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

Return value

TInt 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.

virtual TInt SetParam16(TUint aTag, TUint aIfd, HBufC16 *aParam)=0;

Description

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

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

Return value

TInt 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.

virtual TInt SetIntegerParam(TUint aTag, TUint aIfd, TInt aParam)=0;

Description

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

Parameters

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

Return value

TInt 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.

virtual TInt SetShortParam(TUint aTag, TUint aIfd, TUint16 aParam)=0;

Description

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

Parameters

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

Return value

TInt 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.

virtual TInt SetRationalParam(TUint aTag, TUint aIfd, TInt aNumerator, TInt aDenominator)=0;

Description

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

Parameters

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

Return value

TInt 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.

virtual TInt SetIntegerArrayParam(TUint aTag, TUint aIfd, CArrayFix< TInt > &aParam)=0;

Description

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

Parameters

TUint aTag the tag id where the data is stored TUint aIfd the ifd section in which the tag is stored. CArrayFix< TInt > &aParam the list of values value for the tag

Return value

TInt 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.

virtual TInt SetShortArrayParam(TUint aTag, TUint aIfd, CArrayFix< TUint16 > &aParam)=0;

Description

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

Parameters

TUint aTag the tag id where the data is stored TUint aIfd the ifd section in which the tag is stored. CArrayFix< TUint16 > &aParam the list of values value for the tag

Return value

TInt 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.

virtual TInt SetRationalArrayParam(TUint aTag, TUint aIfd, CArrayFix< TRational > &aParam)=0;

Description

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

Parameters

TUint aTag the tag id where the data is stored TUint aIfd the ifd section in which the tag is stored. CArrayFix< TRational > &aParam the list of values value for the tag

Return value

TInt 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.