// 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:
//

/**
 @file
 @publishedPartner
 @prototype
*/

#ifndef SGRESOURCE_INL
#define SGRESOURCE_INL

/**
@publishedPartner
@prototype
@deprecated

Compares this identifier with another one to check if they are the same.

@param aId The other identifier to compare against.
@pre None.
@post None.
@return ETrue if the two identifiers are the same, EFalse otherwise.
*/
inline TBool TSgDrawableId::operator ==(const TSgDrawableId& aId) const
	{
	return iId[0] == aId.iId[0]
		&& iId[1] == aId.iId[1]
		&& iId[2] == aId.iId[2]
		&& iId[3] == aId.iId[3]
		&& iId[4] == aId.iId[4]
		&& iId[5] == aId.iId[5];
	}


/**
@publishedPartner
@prototype
@deprecated

Compares this identifier with another one to check if they are different.

@param aId The other identifier to compare against.
@pre None.
@post None.
@return ETrue if the two identifiers are different, EFalse otherwise.
*/
inline TBool TSgDrawableId::operator !=(const TSgDrawableId& aId) const
	{
	return !operator ==(aId);
	}


/**
@publishedPartner
@prototype
@deprecated

Retrieves the type of a handle derived from RSgDrawable as a globally unique identifier.
The type is set by the constructor of the handle and does not depend on the run-time
type of the referenced drawable resource.

@pre None.
@post None.
@return The type of the handle as a globally unique identifier.
@see RSgDrawable::DrawableType()
*/
inline TUid RSgDrawable::HandleType() const
	{
	return iHandleType;
	}

/**
@publishedPartner
@prototype
@deprecated

Makes an extension interface available on a drawable resource. The extension interface
is specified by type. The following example demonstrates how to use this function
to get access to an extension interface.

@code
	MExampleExtensionInterface* interface;
	if (drawable.GetInterface(interface) == KErrNone)
		{
@endcode

@param aInterfacePtr On return, a pointer to the specified interface.
@pre The Graphics Resource driver is initialised for use in the context of the
     calling process.
@pre This RSgDrawable handle is valid and not null.
@pre The specified interface is supported on the drawable resource.
@post The specified interface is available until this RSgDrawable handle is closed.
@return KErrNone if successful.
@return KErrBadHandle if this RSgDrawable handle is null.
@return KErrExtensionNotSupported if the specified interface is not supported on
        the drawable resource.
@return KErrNoMemory if there is not enough system memory.
@panic SGRES 2 in debug builds if this RSgDrawable handle is invalid.
@panic SGRES 5 in debug builds if the Graphics Resource driver is not initialised
       for use in the context of the calling process.
@see RSgDrawable::GetInterface<M>(const M*&) const

WARNING: Function for internal use ONLY.  Compatibility is not guaranteed in future releases. 
*/
template<class M>
inline TInt RSgDrawable::GetInterface(M*& aInterfacePtr)
	{
	return GetInterface(TUid::Uid(M::EInterfaceUid), (TAny*&)aInterfacePtr);
	}

/**
@publishedPartner
@prototype
@deprecated

Makes an extension interface available on a drawable resource. The extension interface
is specified by type and returned const-qualified. The following example demonstrates
how to use this function to get access to an extension interface.

@code
	const MExampleExtensionInterface* interface;
	if (drawable.GetInterface(interface) == KErrNone)
		{
@endcode

@param aInterfacePtr On return, a pointer to the specified interface.
@pre The Graphics Resource driver is initialised for use in the context of the
     calling process.
@pre This RSgDrawable handle is valid and not null.
@pre The specified interface is supported on the drawable resource.
@post The specified interface is available until this RSgDrawable handle is closed.
@return KErrNone if successful.
@return KErrBadHandle if this RSgDrawable handle is null.
@return KErrExtensionNotSupported if the specified interface is not supported on
        the drawable resource.
@return KErrNoMemory if there is not enough system memory.
@panic SGRES 2 in debug builds if this RSgDrawable handle is invalid.
@panic SGRES 5 in debug builds if the Graphics Resource driver is not initialised
       for use in the context of the calling process.
@see RSgDrawable::GetInterface<M>(M*&)

WARNING: Function for internal use ONLY.  Compatibility is not guaranteed in future releases. 
*/
template<class M>
inline TInt RSgDrawable::GetInterface(const M*& aInterfacePtr) const
	{
	return GetInterface(TUid::Uid(M::EInterfaceUid), (TAny*&)aInterfacePtr);
	}

#endif // SGRESOURCE_INL