1 /*

     2 * Copyright (c) 2004 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  This class implements an 3gp metadata parser as specified in

    15 *                www.3gpp.org (specification 3GPP TS 26.244 V6.0.0).

    16 *

    17 */

    18 

    19 

    20 

    21 #ifndef CMETADATAPARSER3GP_H

    22 #define CMETADATAPARSER3GP_H

    23 

    24 // INCLUDES

    25 #include <e32base.h>

    26 #include "MetaDataParserMP4.h"

    27 #include "MetaDataFieldContainer.h"

    28 #include "MetaDataField.h"

    29 

    30 // CONSTANTS

    31 

    32 

    33 // CLASS DECLARATION

    34 

    35 /**

    36 *  This class implements an 3gp metadata parser.

    37 *

    38 *  @lib MetaDataUtility.lib

    39 *  @since 3.0

    40 */

    41 class CMetaDataParser3gp : public CMetaDataParserMP4

    42 	{

    43     public:  // Constructors and destructor

    44 

    45         /**

    46         * Two-phased constructor.

    47         * @return A pointer to a new instance of parser; NULL if parser is not created.

    48         */

    49         static CMetaDataParser3gp* NewL();

    50 

    51         /**

    52         * Destructor.

    53         */

    54         virtual ~CMetaDataParser3gp();

    55 

    56     public: // Functions from base classes

    57 

    58         /**

    59         * From CMetaDataParser

    60         * Parses the source and if metadata is found, the metadata fields are

    61         * inserted into the container.

    62         * @since 3.0

    63 		* @param aWantedFields An array of TMetaDataFieldId's. Empty array is interpreted as all fields.

    64         * @param aContainer On return, metadata found in aSource is stored here

    65 		* @return void

    66         */

    67 		void ParseL( const RArray<TMetaDataFieldId>& aWantedFields, CMetaDataFieldContainer& aContainer );

    68 		

    69 		/**

    70 		* From CMetaDataParser

    71 		* Validates whether this is valid 3GP source or not.

    72 		* @since 3.0

    73 		* @return ETrue if valid, EFalse otherwise.

    74 		*/	

    75 		TBool ValidateL();

    76 

    77     public: // New functions

    78 

    79     private:

    80 

    81         /**

    82         * C++ default constructor.

    83         */

    84 		CMetaDataParser3gp();

    85 

    86         /**

    87         * By default Symbian 2nd phase constructor is private.

    88         */

    89 		void ConstructL();

    90 

    91         /**

    92         * Append specified metadata to the container, if found.

    93         * @return void

    94 		*/

    95 		void GetAssetBoxL( TUint32 aBoxType, TMetaDataFieldId aFieldId );

    96 		

    97 	private:

    98 		// CenRep key for specific metadata mapping

    99 		TBool iVFKK;

   100 			

   101     };

   102 

   103 #endif      // CMETADATAPARSER3GP_H

   104 

   105 // End of File