/*
* Copyright (c) 2007-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:    Slideshow view volume control.
*
*/





#ifndef C_SHWSLIDESHOWVOLUMECONTROL_H
#define C_SHWSLIDESHOWVOLUMECONTROL_H


// INCLUDES
#include <alf/alfcontrol.h>

// FORWARD DECLARATION
class CAlfImageVisual;
class CAlfTextVisual;
class CFbsBitmap;
class CGlxUiUtility;

class CAlfAnchorLayout;
class CAlfBorderBrush;
class CAlfLineVisual;
class CAlfCurvePathLayout;
class CShwSlideshowVolumeControl;
class CAlfImageBrush;
class CAlfGridLayout;
class CAlfDeckLayout;
class CAlfAnchorLayout;

// CLASS DECLARATION
/**
 *  Volume control declaration.
 * @internal reviewed 07/06/2007 by Kimmo Hoikka
 */
// ---------------------------------------------------------------------------
// CShwSlideshowVolumeControl declaration
// --------------------------------------------------------------------------- 
NONSHARABLE_CLASS( CShwSlideshowVolumeControl ) : public CAlfControl
    {
public:

    /**
     * Two-phased constructor.
     *
     * @return Pointer to newly created object.
     */
     static CShwSlideshowVolumeControl* NewL(
        CAlfEnv& aEnv,
        CGlxUiUtility& aUtility,
        TTimeIntervalMicroSeconds32 aInterval = 0);

    /**
     * Destructor.
     */
    virtual ~CShwSlideshowVolumeControl();

    /**
     * Called when the volume is changed.
     * @param aVolume  The new volume.
     * @param aMaxVolume  The maximum volume.
     */
    void SetVolume(TInt aVolume, TInt aMaxVolume);

    /**
     * Notifies the control that its visible has been changed on a display.
     * This is the earliest time when the control knows the dimensions of
     * the display it is being shown on.
     *
     * @param aIsVisible  ETrue, if the control is now visible on the
     *			display.   EFalse, if the control is about to the hidden 
     *			on the display.
     * @param aDisplay    The display on which the control's visibility 
     * 			is changing.
     * @see CHuiControl
     */	
    void NotifyControlVisibility(TBool aIsVisible, CAlfDisplay& aDisplay);

    /**
     * Called when the control should be redrawn,
     * e.g. after a change in volume.
     */
    void RefreshL();

    /**
     * Called when the control should be hidden,
     * e.g. after a change in volume.
     */
    void Hide();
    
    /**
     * Called when the control should be shown.
     * e.g. Key press and tap event
     */
    TBool ShowControlL();

    /**
     * Method timer calls after time out.
     */
    TInt TimerCallback();

private:

    /**
     * C++ default constructor.
     */
    CShwSlideshowVolumeControl( CAlfEnv& aEnv,
                                CGlxUiUtility& aUtility,
                                TTimeIntervalMicroSeconds32 aInterval);

    /**
     * By default Symbian 2nd phase constructor is private.
     */
    void ConstructL( );

    /**
     * Helper function to retrieve and position the control's visuals
     */
    void SetAndLayoutVisualsL();

    /**
     * Helper function to convert the current volume to a percentage
     */	
    TInt CurrentVolumeAsPercentage();

    /**
     * Helper function to setup the visuals when volume is muted
     */	
    void SetMuteVisualVisibility();

    /**
     * Helper function to setup the visuals when volume is
     * neither muted nor maximum
     */	
    void SetValueVisualVisibilityL(TInt aVolume);

    /**
     * Helper function to setup the visuals when volume is maximum
     */	
    void CreateFullVolumeVisualsL(TInt aVolume);

    /**
     * Helper function to remove the visuals from the layout
     */	
    void RemoveLayoutVisuals();

    /**
     * Helper function to remove the visuals from the layout
     */	
    void RemoveControlVisuals();
	
private:
	
    CGlxUiUtility& iUtility; // not owned
    
    /** main parent layout*/
    CAlfAnchorLayout* iMainVisual;
    
    /* deck layout holds the backgroung visual, mute visual and the value grid */
    CAlfDeckLayout* iVisualDeck;
    
    /**holds the speaker icon and the percentage text*/
    CAlfGridLayout* iValueGridVisual;
    
    CAlfImageBrush* iBrush; // owned

    // The visual elements of the control
    CAlfImageVisual* iBackgroundImageVisual; // owned
    CAlfImageVisual* iMuteImageVisual;		// owned
    CAlfImageVisual* iSpeakerImageVisual;   // owned
    CAlfTextVisual* iPercentTextVisual;   	// owned

    TInt iVolume;		// owned
    TInt iMaxVolume;	//owned

    CPeriodic*	iTimer;	// owned
    TTimeIntervalMicroSeconds32 iInterval; // owned

    TSize iControlSize; // owned
    CAlfEnv& iAlfEnv; //not owned
    };

#endif  // C_SHWSLIDESHOWVOLUMECONTROL_H

// End of File