/*
* Copyright (c) 2008 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:  This Custom API is created to fix the synchronization problem
*                between Camera Application and Camera Server about the current
*                screen orientation. CWsScreenDevice is used as a reference and
*                Camera Application should use its NumScreenModes() and
*                GetScreenModeSizeAndRotation() methods to inform it by the mode
*                index, which mode it is currently in. It is most likely the one
*                also returned by CurrentScreenMode() but also other mode can be
*                given. Camera server then returns an error if that mode is not
*                supported and some alternative value should be used if it's
*                wanted to be set.
*
*/


#ifndef ECAMUIORIENTATIONOVERRIDECUSTOMAPI_H
#define ECAMUIORIENTATIONOVERRIDECUSTOMAPI_H

#include <e32base.h>

// CONSTANTS

const TUid KCameraUIOrientationOverrideUid = { 0x2001E2AE };

// CLASS DECLARATION

/**
*  Custom interface for Orientation setting.
*/
class MCameraUIOrientationOverride
    {

    public: 

        /**
        * Sets Orientation mode and is based on wsini.ini that can be fetched
        * from CWsScreenDevice. This method should be called after calling
        * CCamera::New2L(), before CCamera::Reserve() and before
        * CCamera::CameraInfo().
        * @param aMode Mode that specifies the wanted orientation
        * @leave KErrNotSupported if aMode is not supported
        * @leave KErrGeneral if this method is not supported
        * @leave KErrInUse if this method is not called at the right time
        */
        virtual void SetOrientationModeL( TInt aMode ) = 0;

    };

#endif //ECAMUIORIENTATIONOVERRIDECUSTOMAPI_H