--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/graphicsresourceservices/graphicsresource/inc/sgimagecollectionadapter.h	Tue Feb 02 01:47:50 2010 +0200
@@ -0,0 +1,121 @@
+// 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