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

//

#ifndef MMFVIDEOSURFACECUSTOMCOMMANDS_H

#define MMFVIDEOSURFACECUSTOMCOMMANDS_H

#include <mmf/common/mmfcontroller.h>

#include <mmf/common/mmfvideo.h>

#include <graphics/surface.h>

/**

@publishedPartner

@prototype

*/

const TUid KUidInterfaceMMFVideoPlaySurfaceSupport = {0x1028340D};

/**

@publishedPartner 

@prototype

The controller sends this event when (1) a surface has been created after a play command and

the first frame for the stream has been passed to the surface, and (2) when an existing surface

should be replaced with a newly created surface. 

*/

const TUid KMMFEventCategoryVideoSurfaceCreated = { 0x1028340F };

/**

@publishedPartner 

@prototype

*/

const TUid KMMFEventCategoryVideoSurfaceParametersChanged = { 0x10283410 };

/**

@publishedPartner 

@prototype

The controller sends this event when a surface must be replaced with another surface

but there are not enough resources to have both created at the same time. The client

utility must respond with MvpssSurfaceRemovedL() command.

*/

const TUid KMMFEventCategoryVideoRemoveSurface = { 0x10283411 };

/**

@publishedPartner 

@prototype

Mixin class for the custom commands implemented by the controller. The custom command parser calls 

methods in this class to deliver the requests to the controller.

*/

class MMMFVideoPlaySurfaceSupportCustomCommandImplementor

	{

public:

	/**

	Enables using graphics surfaces for video playback.

	An interface implemented by either the decoder or the controller.

	*/

	virtual void MvpssUseSurfacesL() = 0;

	/**

	Gets surface parameters.

	An interface implemented by either the decoder or the controller.

	@param  aSurfaceId

	        Surface id of the current surface.

	@param  aCropRect

	        Cropping rectangle within the surface. The crop rectangle identifies the area of 

	        the surface that should be shown on the screen.

	@param  aPixelAspectRatio

	        Video picture pixel aspect ratio.

	*/

	virtual void MvpssGetSurfaceParametersL(TSurfaceId& aSurfaceId, TRect& aCropRect,

											TVideoAspectRatio& aPixelAspectRatio) = 0;

	/**

	Informs the controller that the surface is no longer in use and can

	be destroyed.

	An interface implemented by either the decoder or the controller.

	@param  aSurfaceId

	        Surface that has been removed and can be destroyed.

	*/

	virtual void MvpssSurfaceRemovedL(const TSurfaceId& aSurfaceId) = 0;

	};

/**

@publishedPartner 

@prototype

Custom command parser class to be used by controller plugins wishing to support video surface play 

controller commands.

The controller plugin must be derived from MMMFVideoPlaySurfaceSupportCustomCommandImplementor to use 

this class. The controller plugin should create an object of this type and add it to the list of 

custom command parsers in the controller framework.

*/

class CMMFVideoPlaySurfaceSupportCustomCommandParser : public CMMFCustomCommandParserBase

	{

public:

	/**

	Creates a new custom command parser capable of handling video surface support commands.

	@param  aImplementor

	        A reference to the controller plugin that owns this new object.

	@return A pointer to the object created.

	*/

	IMPORT_C static CMMFVideoPlaySurfaceSupportCustomCommandParser* NewL(MMMFVideoPlaySurfaceSupportCustomCommandImplementor& aImplementor);

	/**

	Destructor.

	*/

	IMPORT_C ~CMMFVideoPlaySurfaceSupportCustomCommandParser();

	/**

	Handles a request from the client. Called by the controller framework.

	@param  aMessage

	        The message to be handled.

	*/

	void HandleRequest(TMMFMessage& aMessage);

private:

	/**

	Constructor.

	@param  aImplementor

	        A reference to the controller plugin that owns this new object.

	*/

	CMMFVideoPlaySurfaceSupportCustomCommandParser(MMMFVideoPlaySurfaceSupportCustomCommandImplementor& aImplementor);

	// Internal request handling methods.

	void DoHandleRequestL(TMMFMessage& aMessage);

	TBool DoUseSurfacesL(TMMFMessage& aMessage);

	TBool DoGetSurfaceParametersL(TMMFMessage& aMessage);

	TBool DoSurfaceRemovedL(TMMFMessage& aMessage);

private:

	/** 

	The object that implements the video surface support interface 

	*/

	MMMFVideoPlaySurfaceSupportCustomCommandImplementor& iImplementor;

	};

/**

@publishedPartner 

@prototype

Client class to access functionality specific to a video surface support playback controller.

The class uses the custom command function of the controller plugin, and removes the necessity

for the client to formulate the custom commands.

*/

class RMMFVideoPlaySurfaceSupportCustomCommands : public RMMFCustomCommandsBase

	{

public:

	/**

	Constructor.

	@param  aController

	        The client side controller object to be used by this custom command interface.

	*/

	IMPORT_C RMMFVideoPlaySurfaceSupportCustomCommands(RMMFController& aController);

	/**

	Enables using graphics surfaces for video playback.

	Instructs the controller to use graphics surfaces as destination. Note that direct screen 

	access and graphics surface use is mutually exclusive, enabling one will disable the other.

	@return KErrNone if successful. KErrNotSupported if graphic surfaces are not supported by the 

	controller or otherwise one of the system wide error codes.

	*/

	IMPORT_C TInt UseSurfaces() const;

	/**

	Gets the surface parameters for a display.

	The client utility typically calls this in response to KMMFEventCategoryVideoSurfaceCreated and 

	KMMFEventCategoryVideoSurfaceParametersChanged events to retrieve new or updated surface 

	information for a display.

	@param  aSurfaceId

	        Surface id of the current surface.

	@param  aCropRect

	        Cropping rectangle within the surface. The crop rectangle identifies the area of 

	        the surface that should be shown on the screen.

	@param  aPixelAspectRatio

	        Video picture pixel aspect ratio.

	@return KErrNone if successful. KErrNotSupported if graphic surfaces are not supported by the 

	controller or KErrNotReady if no surface is available for the display or otherwise one of the 

	system wide error codes.

	*/

	IMPORT_C TInt GetSurfaceParameters(TSurfaceId& aSurfaceId, TRect& aCropRect, TVideoAspectRatio& aPixelAspectRatio) const;

	/**

	Indicates that the surface is no longer in use and can be destroyed.

	The client utility typically calls this in response to either:

	KMMFEventCategoryVideoSurfaceCreated  - when a surface is already registered with the utility. This

	indicates that the client utility should stop using the current surface and use the one supplied

	in the notification. When the client utility is no longer using the current surface it calls

	SurfaceRemoved()

	KMMFEventCategoryVideoRemoveSurface  - when the current surface should be removed. This indicates

	that the client utility should stop using the current surface immediately. When the client utility

	is no longer using the current surface it calls	SurfaceRemoved()

	@param  aSurfaceId

	        Surface which is no longer being used by client utility.

	@return KErrNone if successful. KErrNotSupported if graphic surfaces are not supported by the 

	controller or KErrNotReady if no surface is available for the display or otherwise one of the 

	system wide error codes.

	*/

	IMPORT_C TInt SurfaceRemoved(TSurfaceId& aSurfaceId) const;

	};

#endif // MMFVIDEOSURFACECUSTOMCOMMANDS_H