Adding source location effects to the Symbian C++ audio player - Revision history

Hamishwillee: Hamishwillee - Bot update - Fix links

2012-07-04T02:13:03Z

Hamishwillee - Bot update - Fix links

Hamishwillee: moved CS001131 - Adding source location effects to the audio player to Adding source location effects to the Symbian C++ audio player

2012-06-14T01:57:12Z

moved CS001131 - Adding source location effects to the audio player to Adding source location effects to the Symbian C++ audio player

Hamishwillee: Hamishwillee - Bot update - Merge KB into wiki

2012-06-14T01:56:42Z

Hamishwillee - Bot update - Merge KB into wiki

Hamishwillee: Removed protection from "CS001131 - Adding source location effects to the audio player"

2012-06-14T01:56:29Z

Removed protection from "CS001131 - Adding source location effects to the audio player"

Hamishwillee: Hamishwillee - Bot change of template (Template:CodeSnippet) - now using Template:ArticleMetaData

2011-06-24T08:35:38Z

Hamishwillee - Bot change of template (Template:CodeSnippet) - now using Template:ArticleMetaData

Tanjaluodes at 10:00, 21 January 2010

2010-01-21T10:00:46Z

Forum Nokia KB at 12:30, 9 October 2008

2008-10-09T12:30:20Z

Forum Nokia KB: Protected "CS001131 - Adding source location effects to the audio player" [edit=sysop:move=sysop]

2008-10-09T12:30:02Z

Protected "CS001131 - Adding source location effects to the audio player" [edit=sysop:move=sysop]

Forum Nokia KB: 1 revision(s)

2008-10-09T12:29:03Z

1 revision(s)

Technical writer 1 at 12:10, 9 October 2008

2008-10-09T12:10:40Z

New page

__NOTOC__
__NOEDITSECTION__
{{KBCS}}
{{CodeSnippet
|id=CS001131
|platform=S60 3rd Edition
|devices=Nokia N95
|category=Symbian C++
|subcategory=Audio
|creationdate=October 9, 2008
|keywords=CSourceLocation
}}

==Overview==

The S60 platform has several audio enhancement APIs that can be used to modify the audio experience. One of them is the CSourceLocation API. This API makes the audio source's location for the listener appear to change.

This snippet can be self-signed.

==Preconditions==

The audio player must be fully constructed before constructing the instance of the API. This can be done with the following lines of code:

<code cpp>
iMdaAudioPlayerUtility =
CMdaAudioPlayerUtility::NewFilePlayerL(aFileName,
*this,
EMdaPriorityNormal,
EMdaPriorityPreferenceTimeAndQuality);
</code>

==MMP file==

The following capabilities and libraries are required:

CAPABILITY NONE

LIBRARY SourceLocationEffect.lib

HEADER SourceLocationBase.h

==Source file==

First you need to construct the reverb utility instance:
<code cpp>
iSource = CSourceLocation::NewL( *iMdaAudioPlayerUtility );
</code>

To set the source location effect on, you need to set the X,Y, and Z coordinates for the source, and then enable and apply the effect to the player.
<code cpp>
iSource->SetLocationCartesianL(iSourcePositionX,
iSourcePositionY,
iSourcePositionZ);

if(!iSource->IsEnabled())
iSource->EnableL();

iSource->ApplyL();
</code>

You can also and a 3D effect by using a timer that periodically changes the coordinates of the effect.

To set the source location effect off, call the following line of code:
<code cpp>
iSource->DisableL();
</code>

==Test application==

[[AudioEfects.zip]]

==See also==

[[CS001130 - Adding doppler effects to the audio player]]

[[CS001132 - Adding listener's location effects to the audio player]]

[[CS001133 - Adding bass boost to the audio player]]

[[CS001134 - Adding stereo widening to the audio player]]

[[CS001135 - Adding reverb to the audio player]]

[[CS001136 - Adding equalizer to the audio player]]

[[Category:For publishing]]
[[Category:Symbian C++]]
[[Category:Code Examples]]
[[Category:Multimedia]]
[[Category:Audio]]

@@ Line 90: / Line 90: @@
 [[Adding doppler effects to the audio player in Symbian C++]]
-[[CS001132 - Adding listener's location effects to the audio player]]
+[[Adding listener's location effects to the Symbian C++ audio player]]
-[[CS001133 - Adding bass boost to the audio player]]
+[[Adding bass boost to the Symbian C++ audio player]]
-[[CS001134 - Adding stereo widening to the audio player]]
+[[Adding stereo widening to the Symbian C++ audio player]]
-[[CS001135 - Adding reverb to the audio player]]
+[[Adding reverb to the Symbian C++ audio player]]
-[[CS001136 - Adding equalizer to the audio player]]
+[[Adding equalizer to the Symbian C++ audio player]]

← Older revision		Revision as of 10:00, 21 January 2010
Line 92:		Line 92:
	[[Category:Multimedia]]		[[Category:Multimedia]]
	[[Category:Audio]]		[[Category:Audio]]
		+	[[Category:Code Snippet]]

@@ Line 1: / Line 1: @@
-__NOTOC__
+{{ArticleMetaData <!-- v1.2 -->
-__NOEDITSECTION__
-{{KBCS}}
 {{ArticleMetaData
-|id=CS001131
-|platform=S60 3rd Edition
-|devices=Nokia N95
-|category=Symbian C++
-|subcategory=Audio
-|creationdate=October 9, 2008
-|keywords=CSourceLocation
-−
 |sourcecode= <!-- Link to example source code (e.g. [[Media:The Code Example ZIP.zip]]) -->
 |installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) -->
-|sdk=<!-- SDK(s) built and tested against (e.g. [http://linktosdkdownload/ Nokia Qt SDK 1.1]) -->
+|devices= Nokia N95
-|devicecompatability=<!-- Compatible devices (e.g.: All* (must have GPS) ) -->
+|sdk= <!-- SDK(s) built and tested against (e.g. [http://linktosdkdownload/ Nokia Qt SDK 1.1]) -->
-|signing=<!-- Empty or one of Self-Signed, DevCert, Manufacturer -->
+|platform= S60 3rd Edition
-|capabilities=<!-- Capabilities required (e.g. Location, NetworkServices. -->)
+|devicecompatability= <!-- Compatible devices (e.g.: All* (must have GPS) ) -->
-|author=[[User:Technical writer 1]]
+|dependencies= <!-- Any other/external dependencies e.g.: Google Maps Api v1.0 -->
 }}
@@ Line 44: / Line 49: @@
 CAPABILITY NONE
-LIBRARY    SourceLocationEffect.lib
+LIBRARY SourceLocationEffect.lib
-HEADER  SourceLocationBase.h
+HEADER SourceLocationBase.h
@@ Line 83: / Line 88: @@
 ==See also==
-[[CS001130 - Adding doppler effects to the audio player]]
+[[Adding doppler effects to the audio player in Symbian C++]]
 [[CS001132 - Adding listener's location effects to the audio player]]
@@ Line 97: / Line 102: @@
 [[Category:Symbian C++]]
-[[Category:Code Examples]]
+[[Category:Code Snippet]]
 [[Category:Multimedia]]
 [[Category:Audio]]
 [[Category:Code Snippet]]