Navigation:  thinBasic Modules > TBASS > TBASS 3D and EAX >

TBASS_Set3DFactors

Previous pageReturn to chapter overviewNext page

 

Description

 

Sets the factors that affect the calculations of 3D sound.

 

Syntax

 

n = TBASS_SetEAXParameters(DistF, RollF, DoppF)

 

Returns

 

Number

If successful, then %TBASS_TRUE is returned, else %TBASS_FALSE is returned. Use TBASS_ErrorGetCode to get the error code.

 

Parameters

 

Name

Type

Optional

Meaning

DistF

Numeric

No

The distance factor

0 or less = leave current

examples: 1.0 = use meters, 0.9144 = use yards, 0.3048 = use feet. By default library measures distances in meters, you can change this setting if you are using a different unit of measurement.

RollF

Numeric

No

The rolloff factor, how fast the sound quietness with distance

0.0 (min)

10.0 (max)

less than 0.0 = leave current

examples: 0.0 = no rolloff, 1.0 = real world, 2.0 = 2x real.

DoppF

Numeric

No

The doppler factor

0.0 (min)

10.0 (max)

less than 0.0 = leave current

examples: 0.0 = no doppler, 1.0 = real world, 2.0 = 2x real.

The doppler effect is the way a sound appears to change pitch when it is moving towards or away from you. The listener and sound velocity settings are used to calculate this effect, this doppf value can be used to lessen or exaggerate the effect.

 

Remarks

 

As with all 3D functions, use TBASS_Apply3D to apply the changes.

 

Restrictions

 

See also

 

Examples

 

 

© 2004-2008 thinBasic. All rights reserved. Version 1.7.0.0 Web Site: http://www.thinbasic.com