1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/os/graphics/graphicsdeviceinterface/directgdi/src/directgdidrawablesource.cpp	Fri Jun 15 03:10:57 2012 +0200
     1.3 @@ -0,0 +1,92 @@
     1.4 +// Copyright (c) 2007-2009 Nokia Corporation and/or its subsidiary(-ies).
     1.5 +// All rights reserved.
     1.6 +// This component and the accompanying materials are made available
     1.7 +// under the terms of "Eclipse Public License v1.0"
     1.8 +// which accompanies this distribution, and is available
     1.9 +// at the URL "http://www.eclipse.org/legal/epl-v10.html".
    1.10 +//
    1.11 +// Initial Contributors:
    1.12 +// Nokia Corporation - initial contribution.
    1.13 +//
    1.14 +// Contributors:
    1.15 +//
    1.16 +// Description:
    1.17 +//
    1.18 +
    1.19 +#include "directgdidriver.h"
    1.20 +#include "directgdipaniccodes.h"
    1.21 +#include <graphics/directgdidrawablesource.h>
    1.22 +#include <graphics/sgimage.h>
    1.23 +
    1.24 +/**
    1.25 +Default constructor. 
    1.26 +Only for embedding instances of RDirectGdiDrawableSource into other classes as data members. 
    1.27 +Before a RDirectGdiDrawableSource can be used the other constructor must be called. 
    1.28 +*/
    1.29 +EXPORT_C RDirectGdiDrawableSource::RDirectGdiDrawableSource()
    1.30 +	: iDriver(NULL), iHandle(KNullHandle)
    1.31 +	{
    1.32 +	}
    1.33 +
    1.34 +/**
    1.35 +Constructor.
    1.36 +
    1.37 +@param 	aDriver The CDirectGdiDriver for this thread.
    1.38 +
    1.39 +@pre 	The CDirectGdiDriver object has been initialised from the calling thread.
    1.40 +@post 	This handle has a pointer to the CDirectGdiDriver for this thread. 
    1.41 +		This handle is not associated with any DirectGDI adaptation-specific resource.
    1.42 +*/
    1.43 +EXPORT_C RDirectGdiDrawableSource::RDirectGdiDrawableSource(CDirectGdiDriver& aDriver)
    1.44 +	: iDriver(&aDriver), iHandle(KNullHandle)
    1.45 +	{
    1.46 +	}
    1.47 +
    1.48 +/**
    1.49 +Creates a DirectGDI adaptation-specific resource that is bound to the specified
    1.50 +drawable resource so it can be drawn using the DirectGDI rendering API.
    1.51 +
    1.52 +@param 	aDrawable The drawable resource.
    1.53 +
    1.54 +@pre 	CDirectGdiDriver object for this handle has been set. The drawable
    1.55 +		resource has been fully constructed.
    1.56 +@post 	The DirectGDI adaptation-specific resource that is bound to the given
    1.57 +		non-pixel resource is created and this handle is now associated with it.
    1.58 +		The reference counter on the drawable resource is incremented.
    1.59 +
    1.60 +@return KErrNone if successful, KErrArgument if the drawable resource is not
    1.61 +		valid, KErrAlreadyExists if this handle is already associated with a
    1.62 +		DirectGDI adaptation-specific resource, otherwise one of the system-wide
    1.63 +		error codes.
    1.64 +@panic  DGDI 18, if this drawable source has no pointer to its assosicated CDirectGdiDriver.
    1.65 +        This may occur if constructed using the default constructor, and has not yet been 
    1.66 +        assigned to another drawable source created with the constructor overload.
    1.67 +*/
    1.68 +EXPORT_C TInt RDirectGdiDrawableSource::Create(const RSgDrawable& aDrawable)
    1.69 +	{
    1.70 +	GRAPHICS_ASSERT_ALWAYS(iDriver, EDirectGdiPanicDrawableSourceWithoutDriver);
    1.71 +	return iDriver->CreateDrawableSource(*this, aDrawable);
    1.72 +	}
    1.73 +
    1.74 +/**
    1.75 +Destroys the DirectGDI adaptation-specific resource associated with this handle.
    1.76 +Calling this method on a handle that is not associated with any DirectGDI 
    1.77 +adaptation-specific resource will do nothing. Once Close() is called, this handle can be reused.
    1.78 +
    1.79 +@pre 	The CDirectGdiDriver object for this handle has been set.
    1.80 +@post 	The DirectGDI specific resource associated with this handle will be destroyed,
    1.81 +		at any time. This handle is no longer associated with a DirectGDI specific
    1.82 +		resource. The reference counter of the underlying drawable resource is
    1.83 +		decremented.
    1.84 +@panic  DGDI 18, if this drawable source has no pointer to its assosicated CDirectGdiDriver.
    1.85 +        This may occur if constructed using the default constructor, and has not yet been 
    1.86 +        assigned to another drawable source created with the constructor overload.
    1.87 +*/
    1.88 +EXPORT_C void RDirectGdiDrawableSource::Close()
    1.89 +	{
    1.90 +	if (iHandle != KNullHandle)
    1.91 +		{
    1.92 +		GRAPHICS_ASSERT_ALWAYS(iDriver, EDirectGdiPanicDrawableSourceWithoutDriver);
    1.93 +		iDriver->CloseDrawableSource(*this);
    1.94 +		}
    1.95 +	}