// 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 SGIMAGECOLLECTIONADAPTER_H
#define SGIMAGECOLLECTIONADAPTER_H

#include <graphics/sgresourceadapter.h>
#include <graphics/sgimagecollection.h>


/**
@publishedPartner
@prototype
@deprecated

This interface must be implemented by all the user-side objects in the adaptation
layer of the Graphics subsystem which are referenced by instances of RSgImageCollection.
The interface between the user-side and the kernel-side parts of the adaptation
layer is outside the scope of the specification of the Graphics Resource API.

@see RSgImageCollection
*/
class MSgImageCollectionAdapter: public MSgResourceAdapter
	{
public:
	/**
	@publishedPartner
	@prototype

	Retrieves the surface identifier of the image collection represented by this
	adapter object.

	@return The surface identifier of the image collection.
	@see RSgImageCollection::SurfaceId()
	*/
	virtual const TSurfaceId& SurfaceId() const = 0;
	/**
	@publishedPartner
	@prototype
	@deprecated

	Retrieves the values of the attributes of the images in the image collection
	represented by this adapter object.

	@param aInfo On input, the globally unique identifiers of the user-defined
	       attributes to be retrieved from the image collection, if any. On return,
	       the values of the attributes of the images in the collection and the
	       values of the selected user-defined attributes.
	@pre If aInfo.iUserAttributes is not null then it points to an array of
	     aInfo.iUserAttributeCount elements with globally unique identifiers
	     corresponding to user-defined attributes attached to the image collection.
	@return KErrNone if successful.
	@return KErrNotFound if any of the user-defined attributes to be retrieved from
	        the image collection cannot be found.
	@see RSgImageCollection::GetInfo()
	*/
	virtual TInt GetInfo(TSgImageInfo& aInfo) const = 0;
	/**
	@publishedPartner
	@prototype
	@deprecated

	Retrieves the number of images in the image collection represented by this
	adapter object.

	@return The number of images in the image collection.
	@see RSgImageCollection::Count()
	*/
	virtual TInt Count() const = 0;
	/**
	@publishedPartner
	@prototype
	@deprecated

	Opens a new handle to one of the images in the image collection represented by
	this adapter object. If there are no handles to the image open in the calling
	process then this function creates a new adapter object that represents the image
	in the context of the calling process. Otherwise this function just increments
	the reference count of the existing adapter object that represents the image
	in the context of the calling process.

	@param aIndex The index of the image within the image collection.
	@param aResult On return, a pointer to the adapter object that represents the
	       specified image in the collection.
	@pre aIndex is greater than or equal to zero and less than the number of images
	     in the collection.
	@pre aResult is null.
	@post aResult points to either a newly created or an existing adapter object
	      that represents the specified image in the collection. If a new adapter
	      object is created then its initial reference count is one and the reference
	      count for the image collection is incremented by one. Otherwise only the
	      reference count for the adapter object is incremented by one.
	@return KErrNone if successful.
	@return KErrInUse if aResult was not null.
	@return KErrArgument if aIndex is invalid.
	@return KErrNoMemory if there is not enough system memory.
	@see RSgImageCollection::OpenImage()
	*/
	virtual TInt OpenImage(TInt aIndex, MSgDrawableAdapter*& aResult) = 0;
	};


#endif // SGIMAGECOLLECTIONADAPTER_H