--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/mmlibs/mmfw/Recogniser/src/mmruf.h Tue Feb 02 01:56:55 2010 +0200
@@ -0,0 +1,131 @@
+// Copyright (c) 2006-2009 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:
+//
+
+#ifndef MMRUF_H
+#define MMRUF_H
+
+#include <e32cons.h>
+#include <apmrec.h>
+#include <ecom/ecom.h>
+#include <ecom/implementationproxy.h>
+#include "constants.h"
+
+//
+// This class is used to store the results of a match.
+// iConfidence - the confidence of the match
+// iMime - the matched mime-type.
+//
+class TMatch
+ {
+public:
+ TMatch()
+ : iConfidence(CApaDataRecognizerType::ENotRecognized),
+ iMime(NULL)
+ {
+ }
+
+ TMatch(TInt aConfidence, const TText8* aMime)
+ : iConfidence(aConfidence),
+ iMime(aMime)
+ {
+ }
+
+ void Reset()
+ {
+ iConfidence = KConfNotRecognised;
+ iMime = NULL;
+ }
+
+ TInt iConfidence;
+ const TText8* iMime;
+ };
+
+
+//
+// Function prototype for custom format recogniser functions.
+// Forward declaration of CReader required.
+//
+class CReader;
+typedef void (*TCustomProc)(const TDesC& aFileExt, CReader& aReader, TMatch& aMatch);
+
+
+//
+// These macros are used when creating the KSigs table.
+// CUSTOM_SIG - this is to be used when a format cannot be identified
+// from a known header pattern. It takes the MIME-type it
+// tries to identify and a pointer to a function that
+// does the identification.
+// HEADER_SIG - this is to be used when a format can be identified
+// from a known header pattern.
+//
+#define CUSTOM_SIG(mime, funcPtr) {NULL, (mime), (TAny*)(funcPtr), 0}
+#define HEADER_SIG(mime, ext, header) {(ext), (mime), (TAny*)_S8(header), sizeof(header) - 1}
+
+
+//
+// This structure tells the recogniser how to match a format.
+// iExt - the standard file extension for the format.
+// iMime - the defined MIME-type for the format.
+// iHeaderOrProc - a pointer to either a header signature pattern
+// (if iHeaderLen = 0) or a function that carries
+// out in-depth parsing of the file (if iHeaderLen > 0)
+// iHeaderLen - the length of the header signature in characters, or zero
+// if iHeaderOrProc is a pointer to a function.
+//
+typedef struct
+ {
+ const TText* iExt;
+ const TText8* iMime;
+ TAny* iHeaderOrProc;
+ TInt iHeaderLen;
+ }
+TSignature;
+
+
+// UIDs taken from Multimedia Allocation Table.
+static const TInt KRecogniserUID = 0x1027381A;
+static const TUid KMMRUFDLLUid = {0x102825F6};
+
+// The amount of file data wanted from the AppArc framework.
+static const TInt KPreferredBufSize = 256;
+
+// The recogniser priority.
+static const TInt KRecogniserPriority = CApaDataRecognizerType::ENormal;
+
+
+//
+// This class does the recognising.
+//
+class CMMRUF : public CApaDataRecognizerType
+ {
+public:
+ static CMMRUF* NewL();
+ virtual ~CMMRUF();
+ TDataType SupportedDataTypeL(TInt aIndex) const;
+ TDataType SupportedDataTypeL(const TText8* aMime) const;
+ TUint PreferredBufSize();
+
+protected:
+ void DoRecognizeL(const TDesC& aName, const TDesC8& aBuffer);
+ void SetDataTypeL(TInt aConfidence, const TText8* aMime);
+ TUint8 MatchExtension(const TDesC& aFileName, const TText* aExt) const;
+ TUint8 MatchHeader(const TDesC8& aBuffer, const TDesC8& aHeader) const;
+
+private:
+ CMMRUF();
+ };
+
+
+#endif