<< Click to Display Table of Contents >>
## TBASS_Set3DFactors |

Description

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

Syntax

n = TBASS_Set3DFactors(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