1 // Copyright (c) 2007-2009 Nokia Corporation and/or its subsidiary(-ies).
2 // All rights reserved.
3 // This component and the accompanying materials are made available
4 // under the terms of "Eclipse Public License v1.0"
5 // which accompanies this distribution, and is available
6 // at the URL "http://www.eclipse.org/legal/epl-v10.html".
8 // Initial Contributors:
9 // Nokia Corporation - initial contribution.
16 #include "directgdidriver.h"
17 #include "directgdipaniccodes.h"
18 #include <graphics/directgdidrawablesource.h>
19 #include <graphics/sgimage.h>
23 Only for embedding instances of RDirectGdiDrawableSource into other classes as data members.
24 Before a RDirectGdiDrawableSource can be used the other constructor must be called.
26 EXPORT_C RDirectGdiDrawableSource::RDirectGdiDrawableSource()
27 : iDriver(NULL), iHandle(KNullHandle)
34 @param aDriver The CDirectGdiDriver for this thread.
36 @pre The CDirectGdiDriver object has been initialised from the calling thread.
37 @post This handle has a pointer to the CDirectGdiDriver for this thread.
38 This handle is not associated with any DirectGDI adaptation-specific resource.
40 EXPORT_C RDirectGdiDrawableSource::RDirectGdiDrawableSource(CDirectGdiDriver& aDriver)
41 : iDriver(&aDriver), iHandle(KNullHandle)
46 Creates a DirectGDI adaptation-specific resource that is bound to the specified
47 drawable resource so it can be drawn using the DirectGDI rendering API.
49 @param aDrawable The drawable resource.
51 @pre CDirectGdiDriver object for this handle has been set. The drawable
52 resource has been fully constructed.
53 @post The DirectGDI adaptation-specific resource that is bound to the given
54 non-pixel resource is created and this handle is now associated with it.
55 The reference counter on the drawable resource is incremented.
57 @return KErrNone if successful, KErrArgument if the drawable resource is not
58 valid, KErrAlreadyExists if this handle is already associated with a
59 DirectGDI adaptation-specific resource, otherwise one of the system-wide
61 @panic DGDI 18, if this drawable source has no pointer to its assosicated CDirectGdiDriver.
62 This may occur if constructed using the default constructor, and has not yet been
63 assigned to another drawable source created with the constructor overload.
65 EXPORT_C TInt RDirectGdiDrawableSource::Create(const RSgDrawable& aDrawable)
67 GRAPHICS_ASSERT_ALWAYS(iDriver, EDirectGdiPanicDrawableSourceWithoutDriver);
68 return iDriver->CreateDrawableSource(*this, aDrawable);
72 Destroys the DirectGDI adaptation-specific resource associated with this handle.
73 Calling this method on a handle that is not associated with any DirectGDI
74 adaptation-specific resource will do nothing. Once Close() is called, this handle can be reused.
76 @pre The CDirectGdiDriver object for this handle has been set.
77 @post The DirectGDI specific resource associated with this handle will be destroyed,
78 at any time. This handle is no longer associated with a DirectGDI specific
79 resource. The reference counter of the underlying drawable resource is
81 @panic DGDI 18, if this drawable source has no pointer to its assosicated CDirectGdiDriver.
82 This may occur if constructed using the default constructor, and has not yet been
83 assigned to another drawable source created with the constructor overload.
85 EXPORT_C void RDirectGdiDrawableSource::Close()
87 if (iHandle != KNullHandle)
89 GRAPHICS_ASSERT_ALWAYS(iDriver, EDirectGdiPanicDrawableSourceWithoutDriver);
90 iDriver->CloseDrawableSource(*this);