williamr@2
|
1 |
// Copyright (c) 1995-2009 Nokia Corporation and/or its subsidiary(-ies).
|
williamr@2
|
2 |
// All rights reserved.
|
williamr@2
|
3 |
// This component and the accompanying materials are made available
|
williamr@2
|
4 |
// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
|
williamr@2
|
5 |
// which accompanies this distribution, and is available
|
williamr@2
|
6 |
// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
|
williamr@2
|
7 |
//
|
williamr@2
|
8 |
// Initial Contributors:
|
williamr@2
|
9 |
// Nokia Corporation - initial contribution.
|
williamr@2
|
10 |
//
|
williamr@2
|
11 |
// Contributors:
|
williamr@2
|
12 |
//
|
williamr@2
|
13 |
// Description:
|
williamr@2
|
14 |
//
|
williamr@2
|
15 |
|
williamr@2
|
16 |
#ifndef __FBS_H__
|
williamr@2
|
17 |
#define __FBS_H__
|
williamr@2
|
18 |
|
williamr@2
|
19 |
#include <e32std.h>
|
williamr@2
|
20 |
#include <gdi.h>
|
williamr@2
|
21 |
#include <fntstore.h>
|
williamr@2
|
22 |
#include <bitmap.h>
|
williamr@2
|
23 |
#include <fbsmessage.h>
|
williamr@2
|
24 |
|
williamr@2
|
25 |
/**
|
williamr@2
|
26 |
Indicates version of the font and bitmap server without heap locking.
|
williamr@2
|
27 |
@publishedAll
|
williamr@2
|
28 |
@released
|
williamr@2
|
29 |
*/
|
williamr@2
|
30 |
#define SYMBIAN_FBSERV_V2
|
williamr@2
|
31 |
|
williamr@2
|
32 |
/**
|
williamr@2
|
33 |
@internalTechnology
|
williamr@2
|
34 |
*/
|
williamr@2
|
35 |
const TUid KCFbsFontUid = { 268435518 };
|
williamr@2
|
36 |
/**
|
williamr@2
|
37 |
@internalComponent
|
williamr@2
|
38 |
*/
|
williamr@2
|
39 |
const TUid KMultiBitmapRomImageUid = { 268435521 };
|
williamr@2
|
40 |
/**
|
williamr@2
|
41 |
@internalComponent
|
williamr@2
|
42 |
*/
|
williamr@2
|
43 |
const TUint32 KFontBitmapServerUidValue = 0x10003a16;
|
williamr@2
|
44 |
/**
|
williamr@2
|
45 |
@internalComponent
|
williamr@2
|
46 |
*/
|
williamr@2
|
47 |
const TUid KFontBitmapServerUid = { KFontBitmapServerUidValue };
|
williamr@2
|
48 |
/**
|
williamr@2
|
49 |
@internalAll
|
williamr@2
|
50 |
*/
|
williamr@2
|
51 |
IMPORT_C TInt FbsStartup();
|
williamr@2
|
52 |
|
williamr@2
|
53 |
/**
|
williamr@2
|
54 |
Required to ensure BC between NGage and 7.0S platforms.
|
williamr@2
|
55 |
Function is exported at ordinal corresponding to where NGage platform
|
williamr@2
|
56 |
has extended this library and must not be moved.
|
williamr@2
|
57 |
@internalAll
|
williamr@2
|
58 |
*/
|
williamr@2
|
59 |
IMPORT_C void DummyReserved1();
|
williamr@2
|
60 |
|
williamr@2
|
61 |
|
williamr@2
|
62 |
/**
|
williamr@2
|
63 |
Character width and adjustment information.
|
williamr@2
|
64 |
@publishedAll
|
williamr@2
|
65 |
@released
|
williamr@2
|
66 |
*/
|
williamr@2
|
67 |
class SCharWidth
|
williamr@2
|
68 |
{
|
williamr@2
|
69 |
public:
|
williamr@2
|
70 |
/** The left adjust of the character. */
|
williamr@2
|
71 |
TInt iLeftAdjust;
|
williamr@2
|
72 |
/** The right adjust of the character. */
|
williamr@2
|
73 |
TInt iRightAdjust;
|
williamr@2
|
74 |
/** The total width of the character, defined as iLeftAdjust + iWidth + iRightAdjust. */
|
williamr@2
|
75 |
TInt iMove;
|
williamr@2
|
76 |
/** The width of the character. */
|
williamr@2
|
77 |
TInt iWidth;
|
williamr@2
|
78 |
};
|
williamr@2
|
79 |
|
williamr@2
|
80 |
class CFbsRalCache;
|
williamr@2
|
81 |
class CFbsSessionHelper;
|
williamr@2
|
82 |
|
williamr@2
|
83 |
/**
|
williamr@2
|
84 |
A session with the font and bitmap server.
|
williamr@2
|
85 |
@publishedAll
|
williamr@2
|
86 |
@released
|
williamr@2
|
87 |
*/
|
williamr@2
|
88 |
class RFbsSession : protected RSessionBase
|
williamr@2
|
89 |
{
|
williamr@2
|
90 |
// Allow access to internals for test
|
williamr@2
|
91 |
friend class RClean;
|
williamr@2
|
92 |
friend class TestFbs;
|
williamr@2
|
93 |
friend class CTBitmap;
|
williamr@2
|
94 |
friend class CTClean;
|
williamr@2
|
95 |
friend class CTFbs;
|
williamr@2
|
96 |
|
williamr@2
|
97 |
friend class CFbsBitmap;
|
williamr@2
|
98 |
friend class CFbsBitmapAsyncStreamer;
|
williamr@2
|
99 |
public:
|
williamr@2
|
100 |
IMPORT_C RFbsSession();
|
williamr@2
|
101 |
IMPORT_C static TInt Connect();
|
williamr@2
|
102 |
IMPORT_C static TInt Connect(RFs& aFileServer);
|
williamr@2
|
103 |
IMPORT_C static void Disconnect();
|
williamr@2
|
104 |
IMPORT_C static RFbsSession* GetSession();
|
williamr@2
|
105 |
IMPORT_C void CallBack();
|
williamr@2
|
106 |
IMPORT_C void SetCallBack(TCallBack aCallBack);
|
williamr@2
|
107 |
IMPORT_C void ResetCallBack();
|
williamr@2
|
108 |
IMPORT_C TInt ResourceCount();
|
williamr@2
|
109 |
IMPORT_C TInt SendCommand(TInt aMessage,TInt aInt0=0,TInt aInt1=0,TInt aInt2=0,TInt aInt3=0) const;
|
williamr@2
|
110 |
TInt SendCommand(TInt aMessage, const TIpcArgs& aArgs) const;
|
williamr@2
|
111 |
void SendCommand(TInt aMessage, const TIpcArgs& aArgs, TRequestStatus &aStatus) const;
|
williamr@2
|
112 |
IMPORT_C TVersion Version();
|
williamr@2
|
113 |
IMPORT_C TUint8* HeapBase() const;
|
williamr@2
|
114 |
IMPORT_C TInt GetHeapSizes(TInt& aDefaultHeap, TInt& aSmallBmpHeap, TInt& aBigBmpChunk);
|
williamr@2
|
115 |
TInt SessionHandle() const { return Handle(); }
|
williamr@2
|
116 |
TInt AllocScanLineBuffer(TInt aSize);
|
williamr@2
|
117 |
HBufC8* GetScanLineBuffer();
|
williamr@2
|
118 |
void SetCallBackPtr(TInt* aBitmapHandle)const;
|
williamr@2
|
119 |
HBufC8* GetDecompressionBuffer(TInt aSize);
|
williamr@2
|
120 |
HBufC8* GetExtraBuffer(TInt aSize);
|
williamr@2
|
121 |
public:
|
williamr@2
|
122 |
/**
|
williamr@2
|
123 |
Used for testing server side out of memory failures
|
williamr@2
|
124 |
|
williamr@2
|
125 |
@internalTechnology
|
williamr@2
|
126 |
@prototype
|
williamr@2
|
127 |
*/
|
williamr@2
|
128 |
enum THeapFailType
|
williamr@2
|
129 |
{
|
williamr@2
|
130 |
EHeapFailTypeServerMemory,
|
williamr@2
|
131 |
EHeapFailTypeHeapMemory,
|
williamr@2
|
132 |
};
|
williamr@2
|
133 |
private:
|
williamr@2
|
134 |
TBool LookupBitmapInROM(const TDesC& aFilename, TAny*& aAddr);
|
williamr@2
|
135 |
RFs& FileServer() { return *((RFs*)iSpare); }
|
williamr@2
|
136 |
static TInt DoAlloc(RFbsSession*& aNewSession);
|
williamr@2
|
137 |
TInt DoConnect(RFs& aFileServer);
|
williamr@2
|
138 |
private:
|
williamr@2
|
139 |
TInt iConnections;
|
williamr@2
|
140 |
mutable TCallBack iCallBack;
|
williamr@2
|
141 |
RChunk iSharedChunk;
|
williamr@2
|
142 |
CFbsSessionHelper* iHelper;
|
williamr@2
|
143 |
RChunk iLargeBitmapChunk;
|
williamr@2
|
144 |
RFs iFileServer;
|
williamr@2
|
145 |
CFbsRalCache* iRomFileAddrCache;
|
williamr@2
|
146 |
HBufC8* iDecompressionBuffer;
|
williamr@2
|
147 |
HBufC8* iScanLineBuffer;
|
williamr@2
|
148 |
TUint32* iSpare;
|
williamr@2
|
149 |
};
|
williamr@2
|
150 |
|
williamr@2
|
151 |
/**
|
williamr@2
|
152 |
Font managed by the font and bitmap server.
|
williamr@2
|
153 |
CFbsFont objects are used for screen and off-screen bitmap fonts. They are
|
williamr@2
|
154 |
usually obtained by calls to the CBitmapDevice::GetNearestFontInPixels() and
|
williamr@2
|
155 |
MGraphicsDeviceMap::GetNearestFontInTwips() functions.
|
williamr@2
|
156 |
The class implements a number of functions inherited from CFont.
|
williamr@2
|
157 |
@see CBitmapDevice::GetNearestFontInPixels()
|
williamr@2
|
158 |
@see MGraphicsDeviceMap::GetNearestFontInTwips()
|
williamr@2
|
159 |
@publishedAll
|
williamr@2
|
160 |
@released
|
williamr@2
|
161 |
*/
|
williamr@2
|
162 |
class CFbsFont: public CFont
|
williamr@2
|
163 |
{
|
williamr@2
|
164 |
friend class CFbsTypefaceStore;
|
williamr@2
|
165 |
|
williamr@2
|
166 |
private:
|
williamr@2
|
167 |
// From CFont
|
williamr@2
|
168 |
/** Gets the font's UID.
|
williamr@2
|
169 |
All CFbsFont objects have the constant UID KCFbsFontUid. It is safe to cast
|
williamr@2
|
170 |
from CFont* to CFbsFont* if CFont::TypeUid() returns KCFbsFontUid.
|
williamr@2
|
171 |
@return The font's UID. This should be KCFbsFontUid.
|
williamr@2
|
172 |
@see CFont::TypeUid() */
|
williamr@2
|
173 |
virtual TUid DoTypeUid() const { return KCFbsFontUid; }
|
williamr@2
|
174 |
IMPORT_C virtual TInt DoHeightInPixels() const;
|
williamr@2
|
175 |
IMPORT_C virtual TInt DoAscentInPixels() const;
|
williamr@2
|
176 |
IMPORT_C virtual TInt DoCharWidthInPixels(TChar aChar) const;
|
williamr@2
|
177 |
IMPORT_C virtual TInt DoTextWidthInPixels(const TDesC& aText) const;
|
williamr@2
|
178 |
IMPORT_C virtual TInt DoBaselineOffsetInPixels() const;
|
williamr@2
|
179 |
IMPORT_C virtual TInt DoTextCount(const TDesC& aText,TInt aWidthInPixels) const;
|
williamr@2
|
180 |
IMPORT_C virtual TInt DoTextCount(const TDesC& aText,TInt aWidthInPixels,TInt& aExcessWidthInPixels) const;
|
williamr@2
|
181 |
IMPORT_C virtual TInt DoMaxCharWidthInPixels() const;
|
williamr@2
|
182 |
IMPORT_C virtual TInt DoMaxNormalCharWidthInPixels() const;
|
williamr@2
|
183 |
IMPORT_C virtual TFontSpec DoFontSpecInTwips() const;
|
williamr@2
|
184 |
IMPORT_C virtual CFont::TCharacterDataAvailability DoGetCharacterData(TUint aCode, TOpenFontCharMetrics& aMetrics,
|
williamr@2
|
185 |
const TUint8*& aBitmap, TSize& aBitmapSize) const;
|
williamr@2
|
186 |
IMPORT_C virtual TInt DoExtendedFunction(TUid aFunctionId, TAny* aParam = NULL) const;
|
williamr@2
|
187 |
|
williamr@2
|
188 |
public:
|
williamr@2
|
189 |
// New functions
|
williamr@2
|
190 |
IMPORT_C TBool GetFontMetrics(TOpenFontMetrics& aMetrics) const;
|
williamr@2
|
191 |
IMPORT_C TInt TextWidthInPixels(const TDesC& aText) const;
|
williamr@2
|
192 |
IMPORT_C void TextWidthInPixels(const TDesC& aText,SCharWidth& aCharWidth) const;
|
williamr@2
|
193 |
IMPORT_C TInt Handle() const;
|
williamr@2
|
194 |
IMPORT_C TCharacterMetrics CharacterMetrics(TInt aCode,const TUint8*& aBytes) const;
|
williamr@2
|
195 |
IMPORT_C TInt RawTextWidthInPixels(const TDesC& aText) const;
|
williamr@2
|
196 |
IMPORT_C TBool GetFaceAttrib(TOpenFontFaceAttrib& aAttrib) const;
|
williamr@2
|
197 |
IMPORT_C TBool IsOpenFont() const;
|
williamr@2
|
198 |
IMPORT_C TBool HasCharacter(TInt aCode) const;
|
williamr@2
|
199 |
|
williamr@2
|
200 |
protected:
|
williamr@2
|
201 |
IMPORT_C CFbsFont();
|
williamr@2
|
202 |
IMPORT_C ~CFbsFont();
|
williamr@2
|
203 |
IMPORT_C CFbsFont(const CFbsFont& aFont);
|
williamr@2
|
204 |
IMPORT_C CBitmapFont* Address() const;
|
williamr@2
|
205 |
IMPORT_C TInt Duplicate(TInt aHandle);
|
williamr@2
|
206 |
IMPORT_C void Reset();
|
williamr@2
|
207 |
|
williamr@2
|
208 |
private:
|
williamr@2
|
209 |
void InsertCharacterInCache(TInt aCode, CLinkedFontInformation* &aInfo, CBitmapFont* &aBitmapFont) const;
|
williamr@2
|
210 |
|
williamr@2
|
211 |
private:
|
williamr@2
|
212 |
TInt DoFontGetShaping(TFontShapeFunctionParameters* aParam) const;
|
williamr@2
|
213 |
TInt DoFontDeleteShaping(TFontShapeDeleteFunctionParameters* aParam) const;
|
williamr@2
|
214 |
|
williamr@2
|
215 |
protected:
|
williamr@2
|
216 |
RFbsSession* iFbs;
|
williamr@2
|
217 |
CBitmapFont* iAddressPointer;
|
williamr@2
|
218 |
TInt iHandle;
|
williamr@2
|
219 |
TInt iServerHandle;
|
williamr@2
|
220 |
};
|
williamr@2
|
221 |
|
williamr@2
|
222 |
class CDirectFileStore;
|
williamr@2
|
223 |
|
williamr@2
|
224 |
/**
|
williamr@2
|
225 |
Note that this class is not intended for user derivation.
|
williamr@2
|
226 |
A bitmap managed by the font and bitmap server.
|
williamr@2
|
227 |
The class also defines some palette functionality which is not yet
|
williamr@2
|
228 |
implemented, since none of the modes currently supported by screen
|
williamr@2
|
229 |
or bitmaps require variable palettes.
|
williamr@2
|
230 |
Note that the CFbsBitmap format is internal to Symbian, but the
|
williamr@2
|
231 |
Image Converter API can be used to convert such bitmaps to standard formats.
|
williamr@2
|
232 |
CFbsBitmap instances cannot be shared between different threads. They use some shared
|
williamr@2
|
233 |
thread local storage data. If you want to share a bitmap between threads, use Duplicate().
|
williamr@2
|
234 |
@publishedAll
|
williamr@2
|
235 |
@released
|
williamr@2
|
236 |
@see CFbsBitmap::Duplicate()
|
williamr@2
|
237 |
*/
|
williamr@2
|
238 |
class CFbsBitmap : public CBase
|
williamr@2
|
239 |
{
|
williamr@2
|
240 |
friend class TBitmapUtil;
|
williamr@2
|
241 |
friend class CBitwiseBitmap;
|
williamr@2
|
242 |
friend class CFbsBitmapAsyncStreamer;
|
williamr@2
|
243 |
friend class CFbsSessionHelper;
|
williamr@2
|
244 |
public:
|
williamr@2
|
245 |
IMPORT_C CFbsBitmap();
|
williamr@2
|
246 |
IMPORT_C ~CFbsBitmap();
|
williamr@2
|
247 |
IMPORT_C void Reset();
|
williamr@2
|
248 |
IMPORT_C static TInt ScanLineLength(TInt aLength,TDisplayMode aDispMode);
|
williamr@2
|
249 |
IMPORT_C TDisplayMode DisplayMode() const;
|
williamr@2
|
250 |
IMPORT_C TDisplayMode InitialDisplayMode() const;
|
williamr@2
|
251 |
IMPORT_C TInt SetDisplayMode(TDisplayMode aDisplayMode);
|
williamr@2
|
252 |
IMPORT_C TInt Create(const TSize& aSizeInPixels,TDisplayMode aDispMode);
|
williamr@2
|
253 |
IMPORT_C TInt Duplicate(TInt aHandle);
|
williamr@2
|
254 |
IMPORT_C TBool IsRomBitmap() const;
|
williamr@2
|
255 |
IMPORT_C void SetRomBitmapL(CBitwiseBitmap* aRomBitmapPointer,TInt& aBitmapSizeInBytes);
|
williamr@2
|
256 |
IMPORT_C TInt Load(const TDesC& aFileName,TInt32 aId=0,TBool aShareIfLoaded=ETrue);
|
williamr@2
|
257 |
IMPORT_C TInt Load(const TDesC& aFileName,TInt32 aId,TBool aShareIfLoaded,TUint aFileOffset);
|
williamr@2
|
258 |
IMPORT_C TInt LoadAndCompress(const TDesC& aFileName,TInt32 aId=0,TBool aShareIfLoaded=ETrue);
|
williamr@2
|
259 |
IMPORT_C TInt LoadAndCompress(const TDesC& aFileName,TInt32 aId,TBool aShareIfLoaded,TUint aFileOffset);
|
williamr@2
|
260 |
IMPORT_C TInt Load(RFile& aFile,TInt32 aId=0,TBool aShareIfLoaded=ETrue);
|
williamr@2
|
261 |
IMPORT_C TInt Load(RFile& aFile,TInt32 aId,TBool aShareIfLoaded,TUint aFileOffset);
|
williamr@2
|
262 |
IMPORT_C TInt LoadAndCompress(RFile& aFile,TInt32 aId=0,TBool aShareIfLoaded=ETrue);
|
williamr@2
|
263 |
IMPORT_C TInt LoadAndCompress(RFile& aFile,TInt32 aId,TBool aShareIfLoaded,TUint aFileOffset);
|
williamr@2
|
264 |
IMPORT_C TInt Save(const TDesC& aFilename);
|
williamr@2
|
265 |
IMPORT_C TInt Save(RFile& aFile);
|
williamr@2
|
266 |
IMPORT_C static void StoreL(const TDesC& aFilename,TInt aNumSources,const TDesC* aSources[],TInt32 aSourceIds[]);
|
williamr@2
|
267 |
IMPORT_C static void StoreL(RFile& aFile,TInt aNumSources,const TDesC* aSources[],TInt32 aSourceIds[]);
|
williamr@2
|
268 |
IMPORT_C void GetScanLine(TDes8& aBuf,const TPoint& aPixel,TInt aLength,TDisplayMode aDispMode) const;
|
williamr@2
|
269 |
IMPORT_C void SetScanLine(TDes8& aBuf,TInt aY) const;
|
williamr@2
|
270 |
IMPORT_C void GetVerticalScanLine(TDes8& aBuf,TInt aX,TDisplayMode aDispMode) const;
|
williamr@2
|
271 |
IMPORT_C void GetVerticalScanLine(TDes8& aBuf,TInt aX,const TPoint& aDitherOffset,TDisplayMode aDispMode) const;
|
williamr@2
|
272 |
IMPORT_C TInt Handle() const;
|
williamr@2
|
273 |
IMPORT_C SEpocBitmapHeader Header() const;
|
williamr@2
|
274 |
IMPORT_C TInt HorizontalPixelsToTwips(TInt aPixels) const;
|
williamr@2
|
275 |
IMPORT_C TInt HorizontalTwipsToPixels(TInt aTwips) const;
|
williamr@2
|
276 |
IMPORT_C void GetPixel(TRgb& aColor,const TPoint& aPixel) const;
|
williamr@2
|
277 |
IMPORT_C TInt Resize(const TSize& aSizeInPixels);
|
williamr@2
|
278 |
IMPORT_C TSize SizeInPixels() const;
|
williamr@2
|
279 |
IMPORT_C TSize SizeInTwips() const;
|
williamr@2
|
280 |
IMPORT_C void SetSizeInTwips(const MGraphicsDeviceMap* aMap);
|
williamr@2
|
281 |
IMPORT_C void SetSizeInTwips(const TSize& aSizeInTwips);
|
williamr@2
|
282 |
IMPORT_C void ExternalizeL(RWriteStream& aStream) const;
|
williamr@2
|
283 |
IMPORT_C void ExternalizeRectangleL(RWriteStream& aStream,const TRect& aRect) const;
|
williamr@2
|
284 |
IMPORT_C void InternalizeL(RReadStream& aStream);
|
williamr@2
|
285 |
IMPORT_C TInt Compress();
|
williamr@2
|
286 |
IMPORT_C TInt Compress(TBitmapfileCompressionScheme aScheme);
|
williamr@2
|
287 |
IMPORT_C void CompressInBackground(TRequestStatus& aRequestStatus);
|
williamr@2
|
288 |
IMPORT_C TInt CompressInBackground();
|
williamr@2
|
289 |
IMPORT_C void CompressInBackground(TRequestStatus& aRequestStatus, TBitmapfileCompressionScheme aScheme);
|
williamr@2
|
290 |
IMPORT_C TInt CompressInBackground(TBitmapfileCompressionScheme aScheme);
|
williamr@2
|
291 |
IMPORT_C TInt VerticalPixelsToTwips(TInt aPixels) const;
|
williamr@2
|
292 |
IMPORT_C TInt VerticalTwipsToPixels(TInt aTwips) const;
|
williamr@2
|
293 |
IMPORT_C static TBool IsFileInRom(const TDesC& aFilename,TUint32*& aWord);
|
williamr@2
|
294 |
IMPORT_C static TBool IsFileInRom(RFile& aFile,TUint32*& aWord);
|
williamr@2
|
295 |
IMPORT_C TBool IsMonochrome() const;
|
williamr@2
|
296 |
IMPORT_C TBool IsLargeBitmap() const;
|
williamr@2
|
297 |
IMPORT_C void PaletteAttributes(TBool& aModifiable,TInt& aNumEntries) const;
|
williamr@2
|
298 |
IMPORT_C void SetPalette(CPalette* aPalette);
|
williamr@2
|
299 |
IMPORT_C TInt GetPalette(CPalette*& aPalette) const;
|
williamr@2
|
300 |
IMPORT_C TUint32* DataAddress() const;
|
williamr@2
|
301 |
IMPORT_C TInt DataStride() const;
|
williamr@2
|
302 |
IMPORT_C TInt CreateHardwareBitmap(const TSize& aSizeInPixels,TDisplayMode aDispMode,TUid aCreatorUid);
|
williamr@2
|
303 |
IMPORT_C TInt HardwareBitmapHandle() const;
|
williamr@2
|
304 |
IMPORT_C void BeginDataAccess() const;
|
williamr@2
|
305 |
IMPORT_C void EndDataAccess(TBool aReadOnly=EFalse) const;
|
williamr@2
|
306 |
IMPORT_C void LockHeap(TBool aAlways=EFalse) const;
|
williamr@2
|
307 |
IMPORT_C void UnlockHeap(TBool aAlways=EFalse) const;
|
williamr@2
|
308 |
IMPORT_C void LockHeapLC(TBool aAlways=EFalse) const;
|
williamr@2
|
309 |
IMPORT_C static void UnlockHeap(TAny* aFbsBitmap);
|
williamr@2
|
310 |
IMPORT_C TBool IsCompressedInRAM() const;
|
williamr@2
|
311 |
IMPORT_C TInt SwapWidthAndHeight();
|
williamr@2
|
312 |
IMPORT_C static HBufC8* GetDecompressionBuffer(TInt aSize);
|
williamr@2
|
313 |
IMPORT_C TInt GetAllBitmapHandles(RArray<TInt>& aBitmapIdArray) const;
|
williamr@2
|
314 |
IMPORT_C static HBufC8* GetExtraBuffer(TInt aSize);
|
williamr@2
|
315 |
protected:
|
williamr@2
|
316 |
IMPORT_C void GetScanLine(TDes8& aBuf,const TPoint& aPixel,TInt aLength,const TPoint& aDitherOffset,TDisplayMode aDispMode) const;
|
williamr@2
|
317 |
CBitwiseBitmap* Address() const;
|
williamr@2
|
318 |
IMPORT_C CBitwiseBitmap* CleanAddress() const;
|
williamr@2
|
319 |
inline CBitwiseBitmap* CleanAddress(TUint32*& aDataAddress) const;
|
williamr@2
|
320 |
void DoSaveL(RFile& aFile);
|
williamr@2
|
321 |
TInt DoCreate(const TSize& aSizeInPixels,TDisplayMode aDispMode,TUid aCreatorUid);
|
williamr@2
|
322 |
private:
|
williamr@2
|
323 |
TInt DoLoad(RFile& aFile,TInt32 aId,TBool aShareIfLoaded,TUint aFileOffset);
|
williamr@2
|
324 |
TInt DoLoad(const TDesC& aFileName,TInt32 aId,TBool aShareIfLoaded,TUint aFileOffset);
|
williamr@2
|
325 |
TInt DoLoadFromRom(TUint32* aRomPointer, TInt32 aId, TUint aFileOffset, TBool& aRomPointerValid);
|
williamr@2
|
326 |
TBool LoadShiftedRomBmpL(const TDesC& aFileName,TInt32 aId,TUint aFileOffset);
|
williamr@2
|
327 |
static void DoStoreL(CDirectFileStore* aFileStore,CFbsBitmap* aBitmap,TInt aNumSources,const TDesC* aSources[],TInt32 aSourceIds[]);
|
williamr@2
|
328 |
protected:
|
williamr@2
|
329 |
/**
|
williamr@2
|
330 |
@internalComponent
|
williamr@2
|
331 |
*/
|
williamr@2
|
332 |
enum // Flags
|
williamr@2
|
333 |
{
|
williamr@2
|
334 |
EIsRomBitmap = 0x0001
|
williamr@2
|
335 |
};
|
williamr@2
|
336 |
protected:
|
williamr@2
|
337 |
/**
|
williamr@2
|
338 |
@internalComponent
|
williamr@2
|
339 |
*/
|
williamr@2
|
340 |
RFbsSession* iFbs;
|
williamr@2
|
341 |
/**
|
williamr@2
|
342 |
@internalComponent
|
williamr@2
|
343 |
*/
|
williamr@2
|
344 |
CBitwiseBitmap* iAddressPointer;
|
williamr@2
|
345 |
/**
|
williamr@2
|
346 |
@internalComponent
|
williamr@2
|
347 |
*/
|
williamr@2
|
348 |
TUint16 iFlags;
|
williamr@2
|
349 |
/**
|
williamr@2
|
350 |
@internalComponent
|
williamr@2
|
351 |
*/
|
williamr@2
|
352 |
TInt16 iUseCount;
|
williamr@2
|
353 |
/**
|
williamr@2
|
354 |
@internalComponent
|
williamr@2
|
355 |
*/
|
williamr@2
|
356 |
TInt iHandle;
|
williamr@2
|
357 |
/**
|
williamr@2
|
358 |
@internalComponent
|
williamr@2
|
359 |
*/
|
williamr@2
|
360 |
TInt iServerHandle;
|
williamr@2
|
361 |
};
|
williamr@2
|
362 |
|
williamr@2
|
363 |
class CDirectFileStore;
|
williamr@2
|
364 |
|
williamr@2
|
365 |
/**
|
williamr@2
|
366 |
@deprecated
|
williamr@2
|
367 |
@internalComponent
|
williamr@2
|
368 |
*/
|
williamr@2
|
369 |
class CFbsBitmapAsyncStreamer : public CBase
|
williamr@2
|
370 |
{
|
williamr@2
|
371 |
public:
|
williamr@2
|
372 |
enum TMode {ELoad, ESave};
|
williamr@2
|
373 |
public:
|
williamr@2
|
374 |
IMPORT_C ~CFbsBitmapAsyncStreamer();
|
williamr@2
|
375 |
IMPORT_C static CFbsBitmapAsyncStreamer* NewL(TMode aMode);
|
williamr@2
|
376 |
IMPORT_C TInt Load(const TDesC& aFilename,TInt32 aId,TInt& aScanLines);
|
williamr@2
|
377 |
IMPORT_C TBool LoadScanLinesL(TInt aNumberOfScanLines,CFbsBitmap*& aBitmap);
|
williamr@2
|
378 |
IMPORT_C TInt Save(const TDesC& aFilename,CFbsBitmap* aBitmap,TInt32& aId,TInt& aScanLines);
|
williamr@2
|
379 |
IMPORT_C TBool SaveScanLinesL(TInt aNumberOfScanLines);
|
williamr@2
|
380 |
private:
|
williamr@2
|
381 |
CFbsBitmapAsyncStreamer(TMode aMode);
|
williamr@2
|
382 |
void ConstructL();
|
williamr@2
|
383 |
void DoLoadL(const TDesC& aFilename,TInt32 aId);
|
williamr@2
|
384 |
void DoSaveL(RFile& aFile);
|
williamr@2
|
385 |
private:
|
williamr@2
|
386 |
RFbsSession* iFbs;
|
williamr@2
|
387 |
RStoreReadStream iReadStream;
|
williamr@2
|
388 |
RStoreWriteStream iWriteStream;
|
williamr@2
|
389 |
TStreamId iId;
|
williamr@2
|
390 |
CDirectFileStore* iStore;
|
williamr@2
|
391 |
TInt iCurrentScanLine;
|
williamr@2
|
392 |
TUint32* iScanLineBase;
|
williamr@2
|
393 |
CFbsBitmap* iBitmap;
|
williamr@2
|
394 |
SEpocBitmapHeader iHeader;
|
williamr@2
|
395 |
TDisplayMode iDispMode;
|
williamr@2
|
396 |
TMode iMode;
|
williamr@2
|
397 |
};
|
williamr@2
|
398 |
|
williamr@2
|
399 |
|
williamr@2
|
400 |
/**
|
williamr@2
|
401 |
Provides fast read/write access to the pixel data of a bitmap.
|
williamr@2
|
402 |
|
williamr@2
|
403 |
Functionality includes getting and setting the individual pixels of a bitmap.
|
williamr@2
|
404 |
Common to this is the concept of the current pixel position. This is held
|
williamr@2
|
405 |
as member data and is changed by using various efficient functions. For example,
|
williamr@2
|
406 |
incrementing the position's x- or y co-ordinate is much quicker than setting
|
williamr@2
|
407 |
a completely new position. This efficiency issue is important as these functions
|
williamr@2
|
408 |
are used as part of the frequently used blitting DDA used for creating
|
williamr@2
|
409 |
stretched or compressed versions of bitmaps.
|
williamr@2
|
410 |
|
williamr@2
|
411 |
Calls to Begin() and End() must surround any calls to the other member functions.
|
williamr@2
|
412 |
Note that you should always ensure each Begin() is matched by an End() call
|
williamr@2
|
413 |
when using this class.
|
williamr@2
|
414 |
|
williamr@2
|
415 |
Note also that all display modes including EColor16M are supported, but the
|
williamr@2
|
416 |
TDisplayMode values ERgb and ENone are not considered to be display modes.
|
williamr@2
|
417 |
@publishedAll
|
williamr@2
|
418 |
@released
|
williamr@2
|
419 |
*/
|
williamr@2
|
420 |
class TBitmapUtil
|
williamr@2
|
421 |
{
|
williamr@2
|
422 |
public:
|
williamr@2
|
423 |
IMPORT_C void Begin(const TPoint& aPosition);
|
williamr@2
|
424 |
IMPORT_C void Begin(const TPoint& aPosition,const TBitmapUtil& aUtil);
|
williamr@2
|
425 |
IMPORT_C void End();
|
williamr@2
|
426 |
IMPORT_C TBitmapUtil(CFbsBitmap* aBitmap);
|
williamr@2
|
427 |
IMPORT_C TUint32 GetPixel() const;
|
williamr@2
|
428 |
IMPORT_C void SetPixel(TUint32 aValue);
|
williamr@2
|
429 |
IMPORT_C void SetPixel(const TBitmapUtil& aSource);
|
williamr@2
|
430 |
IMPORT_C void SetPos(const TPoint& aPosition);
|
williamr@2
|
431 |
IMPORT_C void DecXPos();
|
williamr@2
|
432 |
IMPORT_C void DecYPos();
|
williamr@2
|
433 |
IMPORT_C void IncXPos();
|
williamr@2
|
434 |
IMPORT_C void IncYPos();
|
williamr@2
|
435 |
private:
|
williamr@2
|
436 |
CFbsBitmap* iFbsBitmap;
|
williamr@2
|
437 |
TUint32* iWordPos;
|
williamr@2
|
438 |
TUint32* iMinWordPos;
|
williamr@2
|
439 |
TUint32* iMaxWordPos;
|
williamr@2
|
440 |
TInt iBpp;
|
williamr@2
|
441 |
TInt iPixelShift;
|
williamr@2
|
442 |
TInt iBitShift;
|
williamr@2
|
443 |
TUint32 iMask;
|
williamr@2
|
444 |
TInt iScanlineWordLength;
|
williamr@2
|
445 |
TBool iWritten;
|
williamr@2
|
446 |
};
|
williamr@2
|
447 |
|
williamr@2
|
448 |
class TFontInfo;
|
williamr@2
|
449 |
|
williamr@2
|
450 |
/**
|
williamr@2
|
451 |
Font and bitmap server typeface store.
|
williamr@2
|
452 |
@publishedAll
|
williamr@2
|
453 |
@released
|
williamr@2
|
454 |
*/
|
williamr@2
|
455 |
class CFbsTypefaceStore : public CTypefaceStore
|
williamr@2
|
456 |
{
|
williamr@2
|
457 |
friend class CWsScreenDevice;
|
williamr@2
|
458 |
public:
|
williamr@2
|
459 |
IMPORT_C static CFbsTypefaceStore* NewL(CGraphicsDevice* aDevice);
|
williamr@2
|
460 |
IMPORT_C ~CFbsTypefaceStore();
|
williamr@2
|
461 |
IMPORT_C TInt AddFile(const TDesC& aName,TInt& aId);
|
williamr@2
|
462 |
IMPORT_C TInt InstallFile(const TDesC& aName,TInt& aId);
|
williamr@2
|
463 |
IMPORT_C void RemoveFile(TInt aId=0);
|
williamr@2
|
464 |
IMPORT_C virtual TInt GetNearestFontInTwips(CFont*& aFont, const TFontSpec& aFontSpec);
|
williamr@2
|
465 |
IMPORT_C TInt GetNearestFontInPixels(CFont*& aFont, const TFontSpec& aFontSpec);
|
williamr@2
|
466 |
IMPORT_C virtual TInt GetNearestFontToDesignHeightInTwips(CFont*& aFont, const TFontSpec& aFontSpec);
|
williamr@2
|
467 |
IMPORT_C TInt GetNearestFontToDesignHeightInPixels(CFont*& aFont, const TFontSpec& aFontSpec);
|
williamr@2
|
468 |
IMPORT_C virtual TInt GetNearestFontToMaxHeightInTwips(CFont*& aFont, const TFontSpec& aFontSpec, TInt aMaxHeight);
|
williamr@2
|
469 |
IMPORT_C TInt GetNearestFontToMaxHeightInPixels(CFont*& aFont, const TFontSpec& aFontSpec, TInt aMaxHeight);
|
williamr@2
|
470 |
IMPORT_C TInt GetFontById(CFont *&aFont,TUid aUid,const TAlgStyle& aAlgStyle);
|
williamr@2
|
471 |
IMPORT_C virtual TInt NumTypefaces() const;
|
williamr@2
|
472 |
IMPORT_C virtual void TypefaceSupport(TTypefaceSupport& aTypefaceSupport,TInt aTypefaceIndex) const;
|
williamr@2
|
473 |
IMPORT_C virtual TInt FontHeightInTwips(TInt aTypefaceIndex,TInt aHeightIndex) const;
|
williamr@2
|
474 |
IMPORT_C TInt FontHeightInPixels(TInt aTypefaceIndex,TInt aHeightIndex) const;
|
williamr@2
|
475 |
IMPORT_C TGlyphBitmapType DefaultBitmapType() const;
|
williamr@2
|
476 |
IMPORT_C void SetDefaultBitmapType(TGlyphBitmapType aType) const;
|
williamr@2
|
477 |
IMPORT_C void SetFontNameAliasL(const TDesC& aFontAlias,const TDesC& aFontName) const;
|
williamr@2
|
478 |
IMPORT_C void SetDefaultLanguageForMetrics(TLanguage aLanguage) const;
|
williamr@2
|
479 |
IMPORT_C static void RemoveFontFileLocksL();
|
williamr@2
|
480 |
IMPORT_C static void RemoveFontFileLocksL(const TDesC& aDrive, TBool aAllFonts);
|
williamr@2
|
481 |
IMPORT_C static void RemoveFontFileLocksL(const TDesC& aFileName);
|
williamr@2
|
482 |
IMPORT_C void ReleaseTwipsCache();
|
williamr@2
|
483 |
IMPORT_C void SetSystemDefaultTypefaceNameL(const TDesC& aFontTypefaceName);
|
williamr@2
|
484 |
IMPORT_C TInt RegisterLinkedTypeface(const CLinkedTypefaceSpecification& aLinkedTypefaceSpec, TInt& aId);
|
williamr@2
|
485 |
private:
|
williamr@2
|
486 |
CFbsTypefaceStore(CGraphicsDevice* aDevice);
|
williamr@2
|
487 |
void ConstructL();
|
williamr@2
|
488 |
TInt CreateFont(CFont*& aFont,const TFontInfo& aFontInfo);
|
williamr@2
|
489 |
TBool IsFontLoaded(CFont*& aFont, const TFontInfo& aFontInfo) const;
|
williamr@2
|
490 |
TInt FontHeight(TInt aTypefaceIndex,TInt aHeightIndex,TInt aMessage) const;
|
williamr@2
|
491 |
TInt GetNearestFontInTwipsAndCreateFont(CFont*& aFont, TFbsMessage aFbsMessage, const TFontSpec& aFontSpec, TInt aMaxHeight = 0);
|
williamr@2
|
492 |
TInt SendGetNearestFontCommandNCreateFont(
|
williamr@2
|
493 |
CFont*& aFont, TFbsMessage aFbsMessage, const TFontSpec& aFontSpec, TInt aMaxHeight = 0);
|
williamr@2
|
494 |
void GetPixelSizeInTwips(TSize& aSize) const;
|
williamr@2
|
495 |
|
williamr@2
|
496 |
private:
|
williamr@2
|
497 |
RFbsSession* iFbs;
|
williamr@2
|
498 |
CGraphicsDevice* iDevice;
|
williamr@2
|
499 |
CFontCache* iTwipsCache;
|
williamr@2
|
500 |
};
|
williamr@2
|
501 |
|
williamr@2
|
502 |
class CDitherColor256;
|
williamr@2
|
503 |
|
williamr@2
|
504 |
/**
|
williamr@2
|
505 |
Copies a bitmap in any display mode of at least 256 colours into a 256
|
williamr@2
|
506 |
colour bitmap, optionally using a user-defined palette.
|
williamr@2
|
507 |
@publishedAll
|
williamr@2
|
508 |
@released
|
williamr@2
|
509 |
*/
|
williamr@2
|
510 |
class CFbsColor256BitmapUtil : public CBase
|
williamr@2
|
511 |
{
|
williamr@2
|
512 |
public:
|
williamr@2
|
513 |
/** Indicates whether or not to use dithering. */
|
williamr@2
|
514 |
enum TDither
|
williamr@2
|
515 |
{
|
williamr@2
|
516 |
/** No dithering. */
|
williamr@2
|
517 |
ENoDither,
|
williamr@2
|
518 |
/** Use the Floyd-Steinberg dithering algorithm. */
|
williamr@2
|
519 |
EFloydSteinberg
|
williamr@2
|
520 |
};
|
williamr@2
|
521 |
public:
|
williamr@2
|
522 |
|
williamr@2
|
523 |
IMPORT_C static CFbsColor256BitmapUtil* NewL(const CPalette* aPalette);
|
williamr@2
|
524 |
|
williamr@2
|
525 |
IMPORT_C TInt CopyBitmap(CFbsBitmap* aColor256Destination,CFbsBitmap* aSource,TDither aDither=ENoDither);
|
williamr@2
|
526 |
|
williamr@2
|
527 |
~CFbsColor256BitmapUtil();
|
williamr@2
|
528 |
private:
|
williamr@2
|
529 |
CFbsColor256BitmapUtil();
|
williamr@2
|
530 |
private:
|
williamr@2
|
531 |
TColor256Util* iColor256Util;
|
williamr@2
|
532 |
CDitherColor256* iDither;
|
williamr@2
|
533 |
};
|
williamr@2
|
534 |
|
williamr@2
|
535 |
#endif
|