diff -r 000000000000 -r 71ca22bcf22a mmserv/metadatautility/Src/MetaDataParserID3v24.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/mmserv/metadatautility/Src/MetaDataParserID3v24.h Tue Feb 02 01:08:46 2010 +0200 @@ -0,0 +1,196 @@ +/* +* Copyright (c) 2004 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: This class implements parsing of ID3v2.4 according to the +* specification found in www.id3.org. Note that only a selected +* frames are supported at this time. +* +*/ + + + +#ifndef CMETADATAPARSERID3V24_H +#define CMETADATAPARSERID3V24_H + +// INCLUDES +#include "MetaDataParserID3v2.h" + +// CLASS DECLARATION + +/** +* This class implements parsing of ID3v2.4. +* +* @lib MetaDataUtility.lib +* @since 3.0 +*/ +class CMetaDataParserID3v24 : public CMetaDataParserID3v2 + { + public: // Constructors and destructor + + /** + * Two-phased constructor. + * @param aSource Reference to a metadata source + * @return A pointer to a new instance of this class + */ + static CMetaDataParserID3v24* NewL( CMetaDataSource& aSource ); + + /** + * Destructor. + */ + virtual ~CMetaDataParserID3v24(); + + private: // Functions from base classes + + /** + * From CMetaDataParserID3v2 + * This function is called from ParseL for header parsing and data initialization. + * @return void + */ + void PrepareToParseL(); + + /** + * From CMetaDataParserID3v2 + * Gets the next field's properties. + * @param aFieldId Field Id, on return. + * @param aFrameHeaderSize Frame header size. + * @param aFrameSize Frame size, on return. + * @return void + */ + void GetNextFieldL( TMetaDataFieldId& aFieldId, TInt& aFrameHeaderSize, TInt& aFrameSize ); + + /** + * From CMetaDataParserID3v2 + * Reads the text information from the source and appends it to the container. + * @param aFieldId Field Id. + * @param aSize Size of the data. + * @return void + */ + void GetTextInfoL( TMetaDataFieldId aFieldId, TInt aSize ); + + /** + * From CMetaDataParserID3v2 + * Reads the Genre from the source and appends it to the container. + * @param aSize Size of the data. + * @return void + */ + void GetGenreL( TInt aSize ); + /** + * From CMetaDataParserID3v2 + * Reads the year from the source and appends it to the container. + * @param aSize Size of the data. + * @return void + */ + void GetTextYearL( TInt aSize ); + + /** + * From CMetaDataParserID3v2 + * Reads the comment from the source and appends it to the container. + * @param aSize Size of the data. + * @return void + */ + void GetCommentL( TInt aSize ); + + /** + * From CMetaDataParserID3v2 + * Reads the Url from the source and appends it to the container. + * @param aSize Size of the data. + * @return void + */ + void GetUrlL( TInt aSize ); + + /** + * From CMetaDataParserID3v2 + * Reads the Url from the source and appends it to the container. + * @param aSize Size of the data. + * @return void + */ + void GetUnsyncLyricsL( TInt aSize ); + + /** + * From CMetaDataParserID3v2 + * Reads the user defined Url from the source and + * appends it to the container. + * @since 3.0 + * @param aSize Size of the data. + * @return void + */ + void GetUserUrlL( TInt aSize ); + + /** + * From CMetaDataParserID3v2 + * Reads the Jpeg from the source and appends it to the container. + * @param aSize Size of the data. + * @return void + */ + void GetJpegL( TInt aSize ); + + /** + * From CMetaDataParserID3v2 + * Reads the duration from the source and appends it to the container. + * @since 3.0 + * @param aSize Size of the data. + * @return void + */ + void GetDurationL( TInt aSize ); + + /** + * From CMetaDataParserID3v2 + * Reads the date from the source and appends it to the container. + * @since 3.0 + * @param aSize Size of the data. + * @return void + */ + void GetTextDateL( TInt aSize ); + + /** + * From CMetaDataParserID3v2 + * Reads the popularimeter appends it to the container. + * @since 3.0 + * @param aSize Size of the data. + * @return void + */ + void GetRatingL (TInt aSize); + + /** + * From CMetaDataParserID3v2 + * Converts to unicode. + * @param aEncoding Encoding of aDesc. + * @param aDesc Source to be converted to unicode. + * @param aUnicode Contains the converted unicode on return. + * @return The number of unconverted characters left at the end of the input descriptor + * (e.g. because the output descriptor is not long enough to hold all the text), + * or one of the error values defined in TError. + */ + TInt ConvertToUnicodeL( TInt aEncoding, const TDesC8& aDesc, TDes16& aUnicode ); + + private: + + /** + * C++ default constructor. + */ + CMetaDataParserID3v24( CMetaDataSource& aSource ); + + /** + * By default Symbian 2nd phase constructor is private. + */ + void ConstructL(); + + private: // Data + + // Metadata source +// CMetaDataSource& iSource; + }; + +#endif // CMETADATAPARSERID3V24_H + +// End of File