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 <graphics/directgdiimagetarget.h>
18 #include "directgdipaniccodes.h"
22 Only for embedding instances of RDirectGdiImageTarget into other classes as data members.
23 Before a RDirectGdiImageTarget can be used the other constructor must be called.
25 EXPORT_C RDirectGdiImageTarget::RDirectGdiImageTarget()
26 : iDriver(NULL), iHandle(KNullHandle)
33 @param aDriver The CDirectGdiDriver for this thread.
35 @pre CDirectGdiDriver object has been initialised from the calling thread.
36 @post This handle class has a pointer to the CDirectGdiDriver object for this
37 thread, and is not associated with any DirectGDI adaptation specific resource.
39 EXPORT_C RDirectGdiImageTarget::RDirectGdiImageTarget(CDirectGdiDriver& aDriver)
40 : iDriver(&aDriver), iHandle(KNullHandle)
45 Creates a DirectGDI adaptation-specific resource from the given image resource
46 so it can be used as a target of DirectGDI rendering.
48 @param aImage The image resource.
50 @pre The CDirectGdiDriver object has been set. The image resource has been
51 fully constructed and created with the correct usage that allows it to
52 be used as a DirectGDI target.
53 @post The DirectGDI adaptation-specific resource that is bound to the given
54 image resource is created and this handle is now associated with it.
55 The reference counter on the image resource is incremented.
57 @return KErrNone if successful, KErrArgument if the image resource is not valid,
58 KErrAlreadyExists if this handle is already associated with a DirectGDI
59 specific resource, KErrNotSupported if the image resource is not created
60 with the correct usage, otherwise one of the system-wide error codes.
62 EXPORT_C TInt RDirectGdiImageTarget::Create(const RSgImage& aImage)
64 GRAPHICS_ASSERT_ALWAYS(iDriver, EDirectGdiPanicImageTargetWithoutDriver);
65 return iDriver->CreateImageTarget(*this, aImage);
69 Destroys the DirectGDI adaptation-specific resource associated with this handle.
70 Calling this method on a handle that is not associated with any DirectGDI
71 adaptation-specific resource will do nothing. Once Close() is called, this handle can be reused.
73 @pre The CDirectGdiDriver object for this handle has been set.
74 @post The DirectGDI specific resource associated with this handle will be destroyed
75 (at any time preferred by the adaptation). This handle is no longer associated
76 with a DirectGDI specific resource. The reference counter of the underlying
77 image resource is decremented.
79 EXPORT_C void RDirectGdiImageTarget::Close()
81 if (iHandle != KNullHandle)
83 GRAPHICS_ASSERT_ALWAYS(iDriver, EDirectGdiPanicImageTargetWithoutDriver);
84 iDriver->CloseImageTarget(*this);