imagingandcamerafws/camerafw/Include/ecamdirectviewfinder.h
changeset 0 40261b775718
equal deleted inserted replaced
-1:000000000000 0:40261b775718
       
     1 // Copyright (c) 2006-2009 Nokia Corporation and/or its subsidiary(-ies).
       
     2 // All rights reserved.
       
     3 // This component and the accompanying materials are made available
       
     4 // under the terms of "Eclipse Public License v1.0"
       
     5 // which accompanies this distribution, and is available
       
     6 // at the URL "http://www.eclipse.org/legal/epl-v10.html".
       
     7 //
       
     8 // Initial Contributors:
       
     9 // Nokia Corporation - initial contribution.
       
    10 //
       
    11 // Contributors:
       
    12 //
       
    13 // Description:
       
    14 //
       
    15 
       
    16 /**
       
    17  @file
       
    18  @publishedAll
       
    19  @released
       
    20 */
       
    21 #ifndef  ECAMDIRECTVIEWFINDER_H
       
    22 #define  ECAMDIRECTVIEWFINDER_H
       
    23 
       
    24 #include <e32base.h>
       
    25 #include <ecam.h>
       
    26 #include <ecam/ecamdirectviewfinderuids.hrh>
       
    27 
       
    28 class MCameraDirectViewFinder;
       
    29 
       
    30 /** 
       
    31 UID used to identify the CCameraDirectViewFinder API.
       
    32 
       
    33 @see CCamera::CCameraDirectViewFinder
       
    34 */
       
    35 static const TUid KECamDirectViewFinderUid 	= {KECamDirectViewFinderUidValue};
       
    36 
       
    37 /** 
       
    38 CCamera direct view finder class is used to provide support for Direct View Finder functionalities like pause/resume.
       
    39 
       
    40 @note This class is not intended for sub-classing and used to standardise existing
       
    41        varieties of implementations.
       
    42 
       
    43 @note   This class features are supposed to be meant for the direct viewfinder started using CCamera methods.
       
    44 
       
    45 @note   If the class methods leave, the output type parameter value is not guaranteed to be valid.
       
    46 
       
    47 @publishedAll
       
    48 @released
       
    49 */
       
    50 class CCamera::CCameraDirectViewFinder : public CBase
       
    51 	{
       
    52 	/* so can use internal factory functions etc. */
       
    53 	friend class CCamera;
       
    54 
       
    55 public:
       
    56    
       
    57 	/** Specifies direct viewfinder state. */ 
       
    58 	enum TViewFinderState
       
    59 		{
       
    60 		/** View Finder is activated */  
       
    61 		EViewFinderActive, 	 
       
    62 		/** View Finder has been paused */
       
    63 		EViewFinderPause,	 
       
    64 		/** View Finder has been stopped or hasn't yet started. Default state. */
       
    65 		EViewFinderInActive
       
    66 		};
       
    67 	
       
    68 public:
       
    69 
       
    70 	IMPORT_C static CCameraDirectViewFinder* NewL(CCamera& aOwner);
       
    71 
       
    72     IMPORT_C void PauseViewFinderDirectL();
       
    73 	IMPORT_C void ResumeViewFinderDirectL();
       
    74 	IMPORT_C TViewFinderState ViewFinderState() const;
       
    75 	
       
    76 	IMPORT_C ~CCameraDirectViewFinder();
       
    77     
       
    78 private:
       
    79 	CCameraDirectViewFinder(CCamera& aOwner);
       
    80 	void ConstructL();
       
    81 	
       
    82 	void SetImplHandle();
       
    83 	
       
    84 private:	
       
    85 	CCamera&                	iOwner;
       
    86 	MCameraDirectViewFinder* 	iImpl;  // not owned
       
    87    };		
       
    88     
       
    89 #endif // ECAMDIRECTVIEWFINDER_H