--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/graphicsdeviceinterface/directgdi/src/directgdiimagetarget.cpp Tue Feb 02 01:47:50 2010 +0200
@@ -0,0 +1,86 @@
+// Copyright (c) 2007-2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of "Eclipse Public License v1.0"
+// which accompanies this distribution, and is available
+// at the URL "http://www.eclipse.org/legal/epl-v10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+//
+
+#include "directgdidriver.h"
+#include <graphics/directgdiimagetarget.h>
+#include "directgdipaniccodes.h"
+
+/**
+Default constructor.
+Only for embedding instances of RDirectGdiImageTarget into other classes as data members.
+Before a RDirectGdiImageTarget can be used the other constructor must be called.
+*/
+EXPORT_C RDirectGdiImageTarget::RDirectGdiImageTarget()
+ : iDriver(NULL), iHandle(KNullHandle)
+ {
+ }
+
+/**
+Constructor.
+
+@param aDriver The CDirectGdiDriver for this thread.
+
+@pre CDirectGdiDriver object has been initialised from the calling thread.
+@post This handle class has a pointer to the CDirectGdiDriver object for this
+ thread, and is not associated with any DirectGDI adaptation specific resource.
+*/
+EXPORT_C RDirectGdiImageTarget::RDirectGdiImageTarget(CDirectGdiDriver& aDriver)
+ : iDriver(&aDriver), iHandle(KNullHandle)
+ {
+ }
+
+/**
+Creates a DirectGDI adaptation-specific resource from the given image resource
+so it can be used as a target of DirectGDI rendering.
+
+@param aImage The image resource.
+
+@pre The CDirectGdiDriver object has been set. The image resource has been
+ fully constructed and created with the correct usage that allows it to
+ be used as a DirectGDI target.
+@post The DirectGDI adaptation-specific resource that is bound to the given
+ image resource is created and this handle is now associated with it.
+ The reference counter on the image resource is incremented.
+
+@return KErrNone if successful, KErrArgument if the image resource is not valid,
+ KErrAlreadyExists if this handle is already associated with a DirectGDI
+ specific resource, KErrNotSupported if the image resource is not created
+ with the correct usage, otherwise one of the system-wide error codes.
+*/
+EXPORT_C TInt RDirectGdiImageTarget::Create(const RSgImage& aImage)
+ {
+ GRAPHICS_ASSERT_ALWAYS(iDriver, EDirectGdiPanicImageTargetWithoutDriver);
+ return iDriver->CreateImageTarget(*this, aImage);
+ }
+
+/**
+Destroys the DirectGDI adaptation-specific resource associated with this handle.
+Calling this method on a handle that is not associated with any DirectGDI
+adaptation-specific resource will do nothing. Once Close() is called, this handle can be reused.
+
+@pre The CDirectGdiDriver object for this handle has been set.
+@post The DirectGDI specific resource associated with this handle will be destroyed
+ (at any time preferred by the adaptation). This handle is no longer associated
+ with a DirectGDI specific resource. The reference counter of the underlying
+ image resource is decremented.
+*/
+EXPORT_C void RDirectGdiImageTarget::Close()
+ {
+ if (iHandle != KNullHandle)
+ {
+ GRAPHICS_ASSERT_ALWAYS(iDriver, EDirectGdiPanicImageTargetWithoutDriver);
+ iDriver->CloseImageTarget(*this);
+ }
+ }