|
1 /* |
|
2 * Copyright (c) 2009 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: |
|
15 * CWmImageConverter declaration |
|
16 * |
|
17 */ |
|
18 |
|
19 #ifndef WMIMAGECONVERTER_H |
|
20 #define WMIMAGECONVERTER_H |
|
21 |
|
22 //includes |
|
23 #include <e32std.h> |
|
24 #include <e32base.h> |
|
25 #include <f32file.h> |
|
26 #include <AknIconUtils.h> // MAknIconFileProvider |
|
27 |
|
28 // Forward declarations |
|
29 class CFbsBitmap; |
|
30 class TAknsItemID; |
|
31 class CWmUnitTest; |
|
32 class MSvgError; |
|
33 |
|
34 // Class declaration |
|
35 /** |
|
36 * CWmImageConverter |
|
37 * Image converter |
|
38 */ |
|
39 NONSHARABLE_CLASS ( CWmImageConverter ) : public MAknIconFileProvider |
|
40 { |
|
41 public: //contructors/destructors |
|
42 /** |
|
43 * Two-phased constructor. |
|
44 * @param aObserver observer |
|
45 */ |
|
46 static CWmImageConverter* NewL(); |
|
47 |
|
48 /** Destructor */ |
|
49 ~CWmImageConverter(); |
|
50 |
|
51 public: // interface methods |
|
52 |
|
53 /** |
|
54 * Parses icon string and prepares logo image. |
|
55 * |
|
56 * @param aIconSize wanted size |
|
57 * @param aIconStr str containing logo icon |
|
58 * @param aBitmap bitmap to create. Empty if fails |
|
59 * @param aMask mask to create. Empty if fails |
|
60 * Supported values: |
|
61 * - skin(<major id> <minor id>):mif(<path> <bitmapid> <maskid>) |
|
62 * - mif(<path> <bitmapid> <maskid>) |
|
63 * - uid(<application uid>) |
|
64 * - <file name>.<png/svg> |
|
65 * |
|
66 * @return Error code |
|
67 */ |
|
68 TInt HandleIconString( |
|
69 const TSize& aIconSize, |
|
70 const TDesC& aIconStr, |
|
71 CFbsBitmap*& aBitmap, |
|
72 CFbsBitmap*& aMask ); |
|
73 |
|
74 /** |
|
75 * Parses icon string and resizes given bitmaps if needed. |
|
76 * Errors are ignored and previos size image will be used. |
|
77 * |
|
78 * @param aIconSize wanted size |
|
79 * @param aIconStr icon string to find out what to resize |
|
80 * @param aBitmap bitmap to resize |
|
81 * @param aMask mask to resize |
|
82 */ |
|
83 void UpdateImageSize( |
|
84 const TSize& aSize, |
|
85 const TDesC& aIconStr, |
|
86 CFbsBitmap& aBitmap, |
|
87 CFbsBitmap& aMask ); |
|
88 |
|
89 private: |
|
90 CWmImageConverter(); |
|
91 void ConstructL(); |
|
92 |
|
93 private: |
|
94 void CheckSvgErrorL( MSvgError* aError ); |
|
95 void HandleIconStringL( const TSize& aIconSize, const TDesC& aIconStr ); |
|
96 |
|
97 void CreateIconFromUidL( const TUid& aUid ); |
|
98 void CreateIconFromSvgL( const TDesC& aFileName ); |
|
99 void CreateIconFromOtherL( const TDesC& aFileName ); |
|
100 void CreateSkinOrMifIconL( |
|
101 const TAknsItemID& aItemId, TInt aBitmapId, |
|
102 TInt aMaskId, const TDesC& aFileName ); |
|
103 // resolvers |
|
104 TBool ResolveUid( const TDesC& aPath, TUid& aUid ); |
|
105 TBool ResolveSkinId( const TDesC& aPath, TAknsItemID& aItemId ); |
|
106 TBool ResolveMifId( const TDesC& aPath, TInt& aBitmapId, |
|
107 TInt& aMaskId, TDes& aFileName ); |
|
108 TBool ResolveSkinIdAndMifId( const TDesC& aPath, TAknsItemID& aItemId, |
|
109 TInt& aBitmapId, TInt& aMaskId, TDes& aFileName ); |
|
110 TBool EndsWith( const TDesC& aString, const TDesC& aPattern ); |
|
111 |
|
112 // helpers |
|
113 TInt ParseNextUint( TLex& aLex, TUint& aValue ); |
|
114 void CopyBitmapL( CFbsBitmap& aTrgBitmap, CFbsBitmap& aSrcBitmap ); |
|
115 |
|
116 private: // from MAknIconFileProvider |
|
117 |
|
118 /** Returns an open file handle to the icon file. */ |
|
119 void RetrieveIconFileHandleL( RFile& aFile, const TIconFileType aType ); |
|
120 |
|
121 /** Stops using this MAknIconFileProvider instance */ |
|
122 void Finished(); |
|
123 |
|
124 private: |
|
125 /** |
|
126 * decoded image |
|
127 */ |
|
128 CFbsBitmap* iBitmap; |
|
129 |
|
130 /** |
|
131 * decoded image mask |
|
132 */ |
|
133 CFbsBitmap* iMask; |
|
134 |
|
135 /** |
|
136 * File name to convert |
|
137 */ |
|
138 TFileName iFilename; |
|
139 |
|
140 /** |
|
141 * size to convert |
|
142 */ |
|
143 TSize iSize; |
|
144 |
|
145 /** |
|
146 * File handle |
|
147 */ |
|
148 RFs iFs; |
|
149 }; |
|
150 |
|
151 #endif // #ifndef WMIMAGECONVERTER_H |
|
152 |
|
153 // end of file |