--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/amms_akn/mmacontrol/inc/cammsbasereverbcontrol.h Tue Apr 27 16:30:29 2010 +0300
@@ -0,0 +1,165 @@
+/*
+* Copyright (c) 2005 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: Manipulates the settings of an audio effect called reverb.
+*
+*/
+
+
+#ifndef CAMMSBASEREVERBCONTROL_H
+#define CAMMSBASEREVERBCONTROL_H
+
+// INCLUDES
+#include <e32base.h>
+#include <EnvironmentalReverbBase.h>
+#include <EnvironmentalReverbUtility.h>
+#include <CustomCommandUtility.h>
+#include "cammseffectcontrol.h"
+// only require if platform support EMC
+#ifdef RD_JAVA_HTTP_EMC_ENABLED
+#include <ReverbControl.h>
+#endif
+// CONSTANTS
+_LIT(KAMMSBaseReverbControl, "ReverbControl");
+_LIT(KAMMSBaseDefaultReverbPreset, "smallroom");
+
+// only require if platform support EMC
+#ifdef RD_JAVA_HTTP_EMC_ENABLED
+using multimedia :: MReverbControl;
+#endif
+// CLASS DECLARATION
+
+/**
+*
+* Controls for the Reverb effect.
+* This class delegates Reverb effect method calls to CReverb.
+*
+*
+* @since 5.1
+*/
+NONSHARABLE_CLASS(CAMMSBaseReverbControl): public CAMMSEffectControl
+{
+public: // destructor
+
+ /**
+ * Destructor.
+ */
+ ~CAMMSBaseReverbControl();
+
+public: // New functions
+
+ /**
+ * Sets the gain level of the reverberation. The value defines what is
+ * the relative level of the first reflections compared to the sound
+ * source without possible distance attenuations, directivities or
+ * obstructions taken into account.
+ *
+ * @param aLevel The new level of the reverberation in millibels.
+ *
+ * @return The value that was actually set.
+ *
+ * @par Leaving:
+ * @li \c KErrArgument - \a aLevel is greater than 0
+ */
+ virtual TInt SetReverbLevelL(TInt aLevel) = 0;
+
+ /**
+ * Sets the reverberation time of the reverb. The reverberation time is
+ * the time taken for the reverberant sound to attenuate by 60 dB from
+ * its initial level. Typical values are in the range from 100 to 20000
+ * milliseconds.
+ * The implementation might not support long reverberation times.
+ * Therefore, the actual time used might be shorter than the time
+ * specified with this method.
+ *
+ * @param aTime The new reverberation time in milliseconds.
+ *
+ * @return The value that was actually set.
+ *
+ * @par Leaving:
+ * @li \c KErrArgument - \a aTime is negative.
+ * From Java API more leave codes are:
+ * - java.lang.IllegalArgumentException - when the given time is
+ * negative
+ * - javax.microedition.media.MediaException - when the changing of the
+ * reverb time is not supported
+ */
+ virtual void SetReverbTimeL(TInt aTime) = 0;
+
+ /**
+ * Gets the gain level of the reverberation.
+ *
+ * @return The level of the reverberation in millibels.
+ */
+ virtual TInt ReverbLevel() = 0;
+
+ /**
+ * Gets the reverberation time.
+ *
+ * @return The time of the reverberation in milliseconds.
+ */
+ virtual TInt ReverbTime() = 0;
+
+ /**
+ * Gets the minimum level of the reverberation.
+ *
+ * @return The minimum level of the reverberation in millibels.
+ */
+ virtual TInt MinReverbLevel() = 0;
+
+ /**
+ * Gets the maximum level of the reverberation.
+ *
+ * @return The maximum level of the reverberation in millibels.
+ */
+ virtual TInt MaxReverbLevel() = 0;
+
+ /**
+ * Gets the current preset index.
+ *
+ */
+ virtual TInt CurrentPresetIndex() = 0;
+
+public:
+
+ virtual const TDesC& ClassName() const = 0;
+
+
+public: // Functions needed by reverb source control
+
+ /**
+ * Returns the environmental reverb utility.
+ * ReverbSourceControl has to use the same instance.
+ * The function creates the instance if they do not exist yet.
+ *
+ * @param aEnvironmentalReverbUtility Returned utility instance.
+ */
+ virtual void GetEnvironmentalReverbUtilityL(
+ CEnvironmentalReverbUtility** aEnvironmentalReverbUtility);
+ // only require if platform support EMC
+#ifdef RD_JAVA_HTTP_EMC_ENABLED
+ virtual MReverbControl* GetReverbControlL();
+#endif
+protected:
+ /**
+ * C++ constructor.
+ * @param aPlayer Player that has this control.
+ */
+ CAMMSBaseReverbControl(CMMAPlayer* aPlayer);
+
+
+};
+
+#endif // CAMMSBASEREVERBCONTROL_H
+
+