Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries over the next few weeks. Thanks for all your past and future contributions.
How to copy Bitmap Handles
Using the Handle() and Duplicate() methods of the CFbsBitmap class we can easily duplicate a bitmap object. The resulting object points to the same bitmap object but can be independently deleted from the original object.
This is due to the fact that CFbsBitmap is really a handle to a Bitmap managed by font and bitmap server. The managed Bitmap object is reference counted and only deleted when reference count reaches zero. So when handle to the Bitmap is duplicated the resulting CFbsBitmap object refereces the same bitmap, only with its reference count incremented.
1. Use these API to share CFbsBitmap instances across threads/processes as you cannot share instances of CFbsBitmap directly between threads.
2. An object can take an independent ownership a CFbsBitmap instances contained by another object without fearing deletion by the containing object.
3. You can also use this technique for making a copy of the bitmap( in the same thread) rather than copying them pixel by pixel for quick,temporary usage.
The following code snippet demonstrates duplicating bitmap handles within a single thread.
//Duplicates a bitmap creating and returning a new CFbsBitmap object.
//Ownership of newly created object vest with the caller.
CFbsBitmap* DuplicateBitmapL(CFbsBitmap & aSourceBitmap)
CFbsBitmap* dstbitmap = new (ELeave) CFbsBitmap;
//Get the handle to source bitmap
//Duplicate the bitmap handle. Increases the RefCount of bitmap
//managed but Fbs Server
//It should be better to track the error returned by Duplicate()
//to get the notification about whether the bitmap is copied successfully or not.
The following code snippet demonstrates duplicating CGulIcon.
CGulIcon* DuplicateBitmapL(CGulIcon& aIcon)
CFbsBitmap* pBitmap = new (ELeave) CFbsBitmap();
CFbsBitmap* pBitMask = new (ELeave) CFbsBitmap();
CGulIcon* Icon = CGulIcon::NewL(pBitmap, pBitMask);
//Both pBitmap and pBitMask are now owned by Icon
return Icon ;
NOTE: This way we are not copying the bitmap to another, we are just creating a (duplicate) handle for the bitmap, in the font and bitmap server.
Also, deleting one bitmap (thus handle) does not affect the other one.