sl@0: // Copyright (c) 2007-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: //
sl@0: 
sl@0: #include "directgdidriver.h"
sl@0: #include "directgdipaniccodes.h"
sl@0: #include <graphics/directgdidrawablesource.h>
sl@0: #include <graphics/sgimage.h>
sl@0: 
sl@0: /**
sl@0: Default constructor. 
sl@0: Only for embedding instances of RDirectGdiDrawableSource into other classes as data members. 
sl@0: Before a RDirectGdiDrawableSource can be used the other constructor must be called. 
sl@0: */
sl@0: EXPORT_C RDirectGdiDrawableSource::RDirectGdiDrawableSource()
sl@0: 	: iDriver(NULL), iHandle(KNullHandle)
sl@0: 	{
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Constructor.
sl@0: 
sl@0: @param 	aDriver The CDirectGdiDriver for this thread.
sl@0: 
sl@0: @pre 	The CDirectGdiDriver object has been initialised from the calling thread.
sl@0: @post 	This handle has a pointer to the CDirectGdiDriver for this thread. 
sl@0: 		This handle is not associated with any DirectGDI adaptation-specific resource.
sl@0: */
sl@0: EXPORT_C RDirectGdiDrawableSource::RDirectGdiDrawableSource(CDirectGdiDriver& aDriver)
sl@0: 	: iDriver(&aDriver), iHandle(KNullHandle)
sl@0: 	{
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Creates a DirectGDI adaptation-specific resource that is bound to the specified
sl@0: drawable resource so it can be drawn using the DirectGDI rendering API.
sl@0: 
sl@0: @param 	aDrawable The drawable resource.
sl@0: 
sl@0: @pre 	CDirectGdiDriver object for this handle has been set. The drawable
sl@0: 		resource has been fully constructed.
sl@0: @post 	The DirectGDI adaptation-specific resource that is bound to the given
sl@0: 		non-pixel resource is created and this handle is now associated with it.
sl@0: 		The reference counter on the drawable resource is incremented.
sl@0: 
sl@0: @return KErrNone if successful, KErrArgument if the drawable resource is not
sl@0: 		valid, KErrAlreadyExists if this handle is already associated with a
sl@0: 		DirectGDI adaptation-specific resource, otherwise one of the system-wide
sl@0: 		error codes.
sl@0: @panic  DGDI 18, if this drawable source has no pointer to its assosicated CDirectGdiDriver.
sl@0:         This may occur if constructed using the default constructor, and has not yet been 
sl@0:         assigned to another drawable source created with the constructor overload.
sl@0: */
sl@0: EXPORT_C TInt RDirectGdiDrawableSource::Create(const RSgDrawable& aDrawable)
sl@0: 	{
sl@0: 	GRAPHICS_ASSERT_ALWAYS(iDriver, EDirectGdiPanicDrawableSourceWithoutDriver);
sl@0: 	return iDriver->CreateDrawableSource(*this, aDrawable);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Destroys the DirectGDI adaptation-specific resource associated with this handle.
sl@0: Calling this method on a handle that is not associated with any DirectGDI 
sl@0: adaptation-specific resource will do nothing. Once Close() is called, this handle can be reused.
sl@0: 
sl@0: @pre 	The CDirectGdiDriver object for this handle has been set.
sl@0: @post 	The DirectGDI specific resource associated with this handle will be destroyed,
sl@0: 		at any time. This handle is no longer associated with a DirectGDI specific
sl@0: 		resource. The reference counter of the underlying drawable resource is
sl@0: 		decremented.
sl@0: @panic  DGDI 18, if this drawable source has no pointer to its assosicated CDirectGdiDriver.
sl@0:         This may occur if constructed using the default constructor, and has not yet been 
sl@0:         assigned to another drawable source created with the constructor overload.
sl@0: */
sl@0: EXPORT_C void RDirectGdiDrawableSource::Close()
sl@0: 	{
sl@0: 	if (iHandle != KNullHandle)
sl@0: 		{
sl@0: 		GRAPHICS_ASSERT_ALWAYS(iDriver, EDirectGdiPanicDrawableSourceWithoutDriver);
sl@0: 		iDriver->CloseDrawableSource(*this);
sl@0: 		}
sl@0: 	}