/*
* Copyright (c) 2005-2007 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 equalization settings of a Player.
*
*/
// INCLUDE FILES
#include <logger.h>
#include "cammsemcequalizercontrol.h"
// ============================ MEMBER FUNCTIONS ===============================
// -----------------------------------------------------------------------------
// CAMMSEMCEqualizerControl::NewLC
// Two-phased constructor.
// -----------------------------------------------------------------------------
CAMMSEMCEqualizerControl* CAMMSEMCEqualizerControl::NewLC(CMMAPlayer* aPlayer)
{
CAMMSEMCEqualizerControl* self =
new(ELeave) CAMMSEMCEqualizerControl(aPlayer);
CleanupStack::PushL(self);
self->ConstructL();
return self;
}
// Destructor
CAMMSEMCEqualizerControl::~CAMMSEMCEqualizerControl()
{
LOG( EJavaAMMS, EInfo, "AMMS::CAMMSEMCEqualizerControl::~CAMMSEMCEqualizerControl");
// Perform DeallocateControl, if the state change has not yet performed it.
DeallocateControl();
if (iAMMSEMCEqualizerEnvironmentalPresetUtility)
delete iAMMSEMCEqualizerEnvironmentalPresetUtility;
delete iPresetNames;
}
// -----------------------------------------------------------------------------
// CAMMSEMCEqualizerControl::BandLevelL
// Gets the gain set for the given equalizer band.
// -----------------------------------------------------------------------------
//
TInt CAMMSEMCEqualizerControl::BandLevelL(TInt aBand)
{
// if aBand is out of range the method must leave with KErrArgument.
if (aBand < 0 || aBand > (NumberOfBands() - 1))
{
User::Leave(KErrArgument);
}
// Returns the band level in mB for the specified band
TInt bandlevel;
TInt aNativeBand = aBand + KAMMSBandOffset;
iMEqualizerControl->BandLevel(aNativeBand,bandlevel);
return bandlevel;
}
// -----------------------------------------------------------------------------
// CAMMSEMCEqualizerControl::MaxBandLevel
// Returns the maximum band level supported.
// -----------------------------------------------------------------------------
//
TInt CAMMSEMCEqualizerControl::MaxBandLevel()
{
// Get the dB range in mB for the equalizer.
TInt min,max;
iMEqualizerControl->DbLevelLimits(min,max);
return max;
}
// -----------------------------------------------------------------------------
// CAMMSEMCEqualizerControl::MinBandLevel
// Returns the minimum band level supported.
// -----------------------------------------------------------------------------
//
TInt CAMMSEMCEqualizerControl::MinBandLevel()
{
// Get the dB range in mB for the equalizer.
TInt min,max;
iMEqualizerControl->DbLevelLimits(min,max);
return min;
}
// -----------------------------------------------------------------------------
// CAMMSEMCEqualizerControl::BandWidth
// Returns the band width in Hz for the specified band.
// -----------------------------------------------------------------------------
//
TInt CAMMSEMCEqualizerControl::BandWidth(TInt aBand)
{
TInt bndwdth;
TInt aNativeBand = aBand + KAMMSBandOffset;
iMEqualizerControl->BandWidth(aNativeBand,bndwdth);
return bndwdth;
}
// -----------------------------------------------------------------------------
// CAMMSEMCEqualizerControl::CenterFrequency
// Returns the center frequency in Hz for a given band.
// -----------------------------------------------------------------------------
//
TInt CAMMSEMCEqualizerControl::CenterFrequency(TInt aBand)
{
TInt cntrfreq;
TInt aNativeBand = aBand + KAMMSBandOffset;
iMEqualizerControl->CenterFrequency(aNativeBand,cntrfreq);
return cntrfreq;
}
// -----------------------------------------------------------------------------
// CAMMSEMCEqualizerControl::CrossoverFrequency
// Returns the cross-over frequency between the given frequency.
// -----------------------------------------------------------------------------
//
TInt CAMMSEMCEqualizerControl::CrossoverFrequency(TInt aBand)
{
TInt aCrossOverFreq;
TInt aNativeBand = aBand + KAMMSBandOffset;
iMEqualizerControl->CrossoverFrequency(aNativeBand, aCrossOverFreq);
return aCrossOverFreq;
}
// -----------------------------------------------------------------------------
// CAMMSEMCEqualizerControl::NumberOfBands
// Gets the number of frequency bands that the equalizer supports.
// -----------------------------------------------------------------------------
//
TInt CAMMSEMCEqualizerControl::NumberOfBands()
{
// Returns the number of equalizer bands.
// AudioEqualizerBase: TUint8 NumberOfBands() const;
TInt aNumOfBands;
iMEqualizerControl->NumberOfBands(aNumOfBands);
return aNumOfBands;
}
// -----------------------------------------------------------------------------
// CAMMSEMCEqualizerControl::SetBandLevelL
// Sets the given equalizer band to the given gain value.
// -----------------------------------------------------------------------------
//
void CAMMSEMCEqualizerControl::SetBandLevelL(
TInt aLevel,
TInt aBand)
{
LOG2( EJavaAMMS, EInfo, "AMMS::CAMMSEMCEqualizerControl::SetBandLevelL: level=%d, band=%d",
aLevel, aBand);
// If aBand or aLevel is out of valid range the method must leave
// with KErrArgument.
if (aBand < 0 ||
aBand > (NumberOfBands() - 1) ||
aLevel < MinBandLevel() ||
aLevel > MaxBandLevel())
{
User::Leave(KErrArgument);
}
TInt aNativeBand = aBand + KAMMSBandOffset;
// Sets the equalizer band level value in mB, ranging from Min to Max
iMEqualizerControl->SetBandLevel(aNativeBand, aLevel);
ApplySettingsL();
}
// -----------------------------------------------------------------------------
// CAMMSEMCEqualizerControl::SetPresetL
// Sets the effect according to the given preset.
// -----------------------------------------------------------------------------
//
void CAMMSEMCEqualizerControl::SetPresetL(const TDesC& aPreset)
{
LOG1( EJavaAMMS, EInfo, "AMMS::CAMMSEMCEqualizerControl::SetPresetL \"%S\"", aPreset.Ptr());
CAudioEqualizer *iAudioEqualizer = NULL;
iAMMSEMCEqualizerEnvironmentalPresetUtility->PrepareEmptyEqualizerUtilitiesL();
iAMMSEMCEqualizerEnvironmentalPresetUtility->GetPresetNamesL(*iPresetNames);
TInt presetPosition = 0;
TInt findPreset = iPresetNames->Find(aPreset, presetPosition);
if (findPreset == 0) // Find returns zero, if a matching element is found.
{
iAudioEqualizer = iAMMSEMCEqualizerEnvironmentalPresetUtility->GetEqualizerAtPresetIndexL(presetPosition);
iCurrentPreset = presetPosition;
}
else
{
iAMMSEMCEqualizerEnvironmentalPresetUtility->DeleteEmptyEqualizerUtilities();
User::Leave(KErrArgument);
}
if (!iAudioEqualizer)
{
iAMMSEMCEqualizerEnvironmentalPresetUtility->DeleteEmptyEqualizerUtilities();
return;
}
//Get all preset data here
// For each band of AudioEqualizer get the band level and set it to iMEqualizerControl
TInt noOfbands = iAudioEqualizer->NumberOfBands();
for (TInt i = 0; i < noOfbands; i++)
{
// Band 0 in JSR-234 equals Band 1 in Effect API
TInt aNativeBand = i + KAMMSBandOffset;
TInt iBandLevel = iAudioEqualizer->BandLevel(aNativeBand);
iMEqualizerControl->SetBandLevel(aNativeBand, iBandLevel);
}
iMEqualizerControl->Apply();
iAMMSEMCEqualizerEnvironmentalPresetUtility->DeleteEmptyEqualizerUtilities();
}
// -----------------------------------------------------------------------------
// CAMMSEMCEqualizerControl::PresetNamesL
// Gets the available preset names.
// -----------------------------------------------------------------------------
//
const CDesCArray& CAMMSEMCEqualizerControl::PresetNamesL()
{
// Returns an array of all preset names (pre-defined and user-defined).
// The pre-defined presets are in the beginning of the list.
iAMMSEMCEqualizerEnvironmentalPresetUtility->PrepareEmptyEqualizerUtilitiesL();
iAMMSEMCEqualizerEnvironmentalPresetUtility->GetPresetNamesL(*iPresetNames);
iAMMSEMCEqualizerEnvironmentalPresetUtility->DeleteEmptyEqualizerUtilities();
return *iPresetNames;
}
// -----------------------------------------------------------------------------
// CAMMSEMCEqualizerControl::PresetL
// Gets the current preset.
// -----------------------------------------------------------------------------
//
const TDesC& CAMMSEMCEqualizerControl::PresetL()
{//if no preset is set, return null
if (iCurrentPreset < 0)
{
return KNullDesC;
}
else
{
// Retrieves a Preset with the given index from the utility class
iAMMSEMCEqualizerEnvironmentalPresetUtility->PrepareEmptyEqualizerUtilitiesL(); // codescanner::leave
iAMMSEMCEqualizerEnvironmentalPresetUtility->GetPresetAtIndexL(iPresetName , iCurrentPreset); // codescanner::leave
iAMMSEMCEqualizerEnvironmentalPresetUtility->DeleteEmptyEqualizerUtilities();
return iPresetName;
}
}
// -----------------------------------------------------------------------------
// CAMMSEMCEqualizerControl::SetEnabledL
// Enables/disables the effect.
// -----------------------------------------------------------------------------
//
void CAMMSEMCEqualizerControl::SetEnabledL(TBool aEnable)
{
if (aEnable)
{
// Enable the effect.
iMEqualizerControl->Enable();
LOG( EJavaAMMS, EInfo, "AMMS::CAMMSEMCEqualizerControl::SetEnabledL(true), calling Apply");
iMEqualizerControl->Apply();
}
else
{
// Disable the effect
LOG( EJavaAMMS, EInfo, "AMMS::CAMMSEMCEqualizerControl::SetEnabledL(false), calling Disable");
iMEqualizerControl->Disable();
iMEqualizerControl->Apply();
}
}
// -----------------------------------------------------------------------------
// CAMMSEMCEqualizerControl::PrepareControlL
// Function which is called after the correct state is set in Player.
// -----------------------------------------------------------------------------
//
void CAMMSEMCEqualizerControl::PrepareControlL()
{
// Perform the action only for the first time, skip if called afterwards
if (!iMEqualizerControl)
{
LOG( EJavaAMMS, EInfo, "AMMS::CAMMSEMCEqualizerControl::PrepareControlL");
//Create Equalizer Effect Control
iStreamControl = (static_cast<CMMAEMCAudioPlayer*>(iMMAPlayer))->StreamControl();
iFactory = (static_cast<CMMAEMCAudioPlayer*>(iMMAPlayer))->MMFactory();
MEffectControl* temp(NULL);
User::LeaveIfError(iFactory->CreateEffectControl(KEqualizerEffectControl, temp));
iMEqualizerControl = static_cast<MEqualizerControl*>(temp);
User::LeaveIfError(iStreamControl->AddEffect(*iMEqualizerControl));
iMEqualizerControl->Enable();
}
}
// -----------------------------------------------------------------------------
// CAMMSEMCEqualizerControl::DeallocateControl
// Function which is called after the correct state is set in Player.
// -----------------------------------------------------------------------------
//
void CAMMSEMCEqualizerControl::DeallocateControl()
{
if (iMEqualizerControl)
{
LOG( EJavaAMMS, EInfo, "AMMS::CAMMSEMCEqualizerControl::DeallocateControl");
// Equalizer for Audio can be disabled or enabled
TRAPD(err,iMEqualizerControl->Disable());
if (err != KErrNone)
{
//Some EMC Error
ELOG1( EJavaAMMS, "AMMS::CAMMSEMCEqualizerControl::DeallocateControl err = %d",err);
}
//return the control to factory
MEffectControl* temp = iMEqualizerControl;
iStreamControl->RemoveEffect(*temp);
// Delete the Effect
MEffectControl* tempCtrl = iMEqualizerControl;
iFactory->DeleteEffectControl(tempCtrl);
iMEqualizerControl = NULL;
}
}
const TDesC& CAMMSEMCEqualizerControl::ClassName() const
{
return KAMMSEMCEqualizerControl;
}
// -----------------------------------------------------------------------------
// CAMMSEMCEqualizerControl::SetEnforcedL
// Enforces the effect to be in use.
// -----------------------------------------------------------------------------
//
void CAMMSEMCEqualizerControl::SetEnforcedL(TBool aEnforced)
{
LOG( EJavaAMMS, EInfo, "AMMS::CAMMSEMCEqualizerControl:SetEnforcedL");
// Indicate the effect is to be enforced or not. ETrue = Enforced.
iMEqualizerControl->Enforce(aEnforced);
ApplySettingsL();
}
// -----------------------------------------------------------------------------
// CAMMSEMCEqualizerControl::Enforced
// Returns the current enforced setting of the effect.
// -----------------------------------------------------------------------------
//
TBool CAMMSEMCEqualizerControl::Enforced()
{
// Returns ETrue if the effect is enforced, EFalse if not enforced.
TBool enforced;
iMEqualizerControl->IsEnforced(enforced);
return enforced;
}
// -----------------------------------------------------------------------------
// CAMMSEMCEqualizerControl::SetScopeL
// Sets the scope of the effect.
// -----------------------------------------------------------------------------
//
void CAMMSEMCEqualizerControl::SetScopeL(TInt aScope)
{
LOG( EJavaAMMS, EInfo, "AMMS::CAMMSEMCEqualizerControl:SetScopeL");
__ASSERT_DEBUG(
(aScope == CAMMSEffectControlGroup::EScopeLiveOnly),
User::Invariant());
// Just to suppress warning in release build
(void)aScope;
}
// -----------------------------------------------------------------------------
// CAMMSEMCEqualizerControl::Scope
// Returns the scope in which the effect is present.
// -----------------------------------------------------------------------------
//
TInt CAMMSEMCEqualizerControl::Scope()
{
// For now only the (LIVE_ONLY) scope is supported.
return CAMMSEffectControlGroup::EScopeLiveOnly;
}
// -----------------------------------------------------------------------------
// CAMMSEMCAudioVirtualizerControl::ApplySettingsL
// Apply changed settings if Effect is in enabled state.
// -----------------------------------------------------------------------------
void CAMMSEMCEqualizerControl::ApplySettingsL()
{
LOG( EJavaAMMS, EInfo, "AMMS::CAMMSEMCEqualizerControl:ApplySettingsL called, checking state");
TBool enabled;
iMEqualizerControl->IsEnabled(enabled);
if (enabled)
{
LOG( EJavaAMMS, EInfo, "AMMS::CAMMSEMCEqualizerControl:ApplySettingsL calling ApplyL");
iMEqualizerControl->Apply();
}
}
// -----------------------------------------------------------------------------
// CAMMSEMCEqualizerControl::ConstructL
// Symbian 2nd phase constructor can leave.
// -----------------------------------------------------------------------------
void CAMMSEMCEqualizerControl::ConstructL()
{
// Create array for preset names
iPresetNames = new(ELeave) CDesCArrayFlat(1);
// Set current preset to a negative value as it is not set yet
iCurrentPreset = -1;
CAMMSEffectControl::ConstructL();
iAMMSEMCEqualizerEnvironmentalPresetUtility = new(ELeave)CAMMSEMCEqualizerEnvironmentalPresetUtility;
iAMMSEMCEqualizerEnvironmentalPresetUtility->ConstructL();
}
// -----------------------------------------------------------------------------
// CAMMSEMCEqualizerControl::CAMMSEMCEqualizerControl
// C++ default constructor can NOT contain any code, that
// might leave.
// -----------------------------------------------------------------------------
CAMMSEMCEqualizerControl::CAMMSEMCEqualizerControl(CMMAPlayer* aPlayer)
: CAMMSBaseEqualizerControl(aPlayer)
{
iMMAPlayer = aPlayer;
}
// End of File