/*

 * Copyright (c) 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:

 * CTVOutConfigForComposite class declaration.

 *

 */

#ifndef TVOUTCONFIGFORCOMPOSITE_H

#define TVOUTCONFIGFORCOMPOSITE_H

// INCLUDES

#include <e32base.h>

#include <tvoutconfigdef.h>

#include "myasynconeshottimercallback.h"

// CONSTANTS

// MACROS

// DATA TYPES

// FUNCTION PROTOTYPES

// FORWARD DECLARATIONS

class CTvOutConfig;

class MFSMForBody;

class CRepository;

class CMyAsyncOneShotTimer;

class TTvSettings;

// CLASS DECLARATION

/**

 *  TV Out Configurer for Composite Cable Status FSM.

 *

 *  @code

 *   ?good_class_usage_example(s)

 *  @endcode

 *

 *  @lib none.

 *  @since TB 9.2

 */

NONSHARABLE_CLASS( CTVOutConfigForComposite ): public CActive,

public MMyAsyncOneShotTimerCallback

    {

public: // Constructors and destructor

    /**

     * Symbian two phased constructor.

     * 

     * @since S60 TB9.2

     * @param aFSMBody A FSM.

     * @return CTVOutConfigForComposite*

     */

    static CTVOutConfigForComposite* NewL( MFSMForBody& aFSM );

    /**

     * Destructor.

     */

    virtual ~CTVOutConfigForComposite();

public: // New methods

    /**

     * Set list of available Tv-configurations.

     * 

     * @since TB9.2

     * @param   aSettingAfterCableConnected Tells whether parameter setting

     *          is requested after cable was connected. If not true then

     *          setting is requested because of a changed value of a parameter.

     * @return Symbian error code.

     */

    void SetConfig( TBool aSettingAfterCableConnected );

    /**

     * Listen for setting changes in TV Out Configuration.

     * 

     * @since TB9.2

     * @param  None.

     * @return void.

     *           

     */

    void ListenSettingsChanges();

    /**

     * Get pointer of CTvOutConfig.

     * 

     * @since TB9.2

     * @param  None.

     * @return CTvOutConfig* Pointer to CTvOutConfig.

     */

    CTvOutConfig* GetTvOutConfig();

    /**

     *  Enables Tv-out. Latest SetConfig() settings are used.

     *

     * @since TB9.2

     * @param  None.

     * @return void.

     */

    void Enable();

    /**

     * Disables Tv-out.

     * 

     * @since TB9.2

     * @param  aAnalogConfigs  Available Analog Tv configurations.

     * @param  None.

     * @return void.

     */

    void Disable();

private:

    /**

     * Initializes the driver with the values from the Central Repository.

     * @aBootTime indicates, if method is called during phone boot

     * @return KErrNone if all went well, system wide error code otherwise.

     */

    TInt InitializeDriverL();

    /**

     * Return the current value of the tv system.

     * @return setting value

     */

    TInt TvSystemL();

    /**

     * Return the current value of the aspect ratio.

     * @return setting value

     */

    TInt AspectRatioL();

    /**

     * Return the current value of the flicker filter.

     * @return setting value.

     */

    TInt FlickerFilterL();

    /**

     * Switching value from 1 to 0 and back

     */

    void ConvertFlickerFilter( TInt& aValue );

    /**

     * Converting aspect ratio value for display driver

     */

    void ConvertAspectRatio( TInt& aValue );

    /**

     * Converting tv system value for display driver

     */

    void ConvertTvSystem( TInt& aValue );

    /**

     * Resolving the Pixel Aspect Ratio denominator and numerator

     */

    void UpdatePixelAspectRatio( TTvSettings& aSettings );

private: // Constructors

    /**

     * C++ constructor.

     * @param aFSMBody A FSM.

     */

    CTVOutConfigForComposite( MFSMForBody& aFSMForBody );

    /**

     * Symbian 2nd phase constructor.

     * 

     */

    void ConstructL();

private:

    // Functions from base classes

    /**

     * RunL()

     */

    void RunL();

    /**

     * DoCancel()

     */

    void DoCancel();

    /**

     * From MMyAsyncOneShotTimerCallback

     * This is called when one shot asyncronous timer has elapsed.

     * 

     * @since TB9.2

     * @param  None.

     * @return void.

     *           

     */

    virtual void OneShotTimeout();

private:

    // Functions from base classes

private:

    // Data

    enum

        {

        EWaitTimeInMsForTvOutConfigBusyServer = 50000

        };

    enum TOpt

        {

        EOptUndefined = 0,

        EOptEnableTv,

        EOptDisableTv,

        EOptIdle,

        EOptSetting,

        EOptStartListenForSettingsChanges,

        EOptListenForSettingsChanges,

        EOptDisableTVBeforeSetting

        };

    // A FSM pointer.

    // Not own.

    MFSMForBody& iFSM;

    // Handle to TV-out config

    // Own

    CTvOutConfig* iTvOutConfig;

    // Handle to the Central Repository.

    // Own

    CRepository* iRepository;

    // Next operation

    TOpt iNextOpt;

    // Tells whether parameter setting is requested after

    // cable was connected. If not true then setting is requested

    // because of a changed value of a parameter.

    TBool iSettingAfterCableConnected;

    // iTvConfig->Disable() called already once

    // before trying iTvConfig->Setting() again.

    TBool iDisabledOnceBeforeSetting;

    // Asynchronous timer 

    CMyAsyncOneShotTimer* iMyAsyncOneShotTimer;

    // Time out reason and next opt after timer has 

    // elapsed

    TOpt iTimeOutReason;

    };

#endif // TVOUTCONFIGFORCOMPOSITE_H