// Copyright (c) 2006-2009 Nokia Corporation and/or its subsidiary(-ies).

// All rights reserved.

// This component and the accompanying materials are made available

// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members

// which accompanies this distribution, and is available

// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".

//

// Initial Contributors:

// Nokia Corporation - initial contribution.

//

// Contributors:

//

// Description:

//

/**

 @file

 @publishedAll

 @released

*/

#ifndef  ECAMDIRECTVIEWFINDER_H

#define  ECAMDIRECTVIEWFINDER_H

#include <e32base.h>

#include <ecam.h>

#include <ecam/ecamdirectviewfinderuids.hrh>

class MCameraDirectViewFinder;

/** 

UID used to identify the CCameraDirectViewFinder API.

@see CCamera::CCameraDirectViewFinder

*/

static const TUid KECamDirectViewFinderUid 	= {KECamDirectViewFinderUidValue};

/** 

CCamera direct view finder class is used to provide support for Direct View Finder functionalities like pause/resume.

@note This class is not intended for sub-classing and used to standardise existing

       varieties of implementations.

@note   This class features are supposed to be meant for the direct viewfinder started using CCamera methods.

@note   If the class methods leave, the output type parameter value is not guaranteed to be valid.

@publishedAll

@released

*/

class CCamera::CCameraDirectViewFinder : public CBase

	{

	/* so can use internal factory functions etc. */

	friend class CCamera;

public:

	/** Specifies direct viewfinder state. */ 

	enum TViewFinderState

		{

		/** View Finder is activated */  

		EViewFinderActive, 	 

		/** View Finder has been paused */

		EViewFinderPause,	 

		/** View Finder has been stopped or hasn't yet started. Default state. */

		EViewFinderInActive

		};

public:

	IMPORT_C static CCameraDirectViewFinder* NewL(CCamera& aOwner);

    IMPORT_C void PauseViewFinderDirectL();

	IMPORT_C void ResumeViewFinderDirectL();

	IMPORT_C TViewFinderState ViewFinderState() const;

	IMPORT_C ~CCameraDirectViewFinder();

private:

	CCameraDirectViewFinder(CCamera& aOwner);

	void ConstructL();

	void SetImplHandle();

private:	

	CCamera&                	iOwner;

	MCameraDirectViewFinder* 	iImpl;  // not owned

   };		

#endif // ECAMDIRECTVIEWFINDER_H