|
<< Click to Display Table of Contents >> Navigation: ThinBASIC Modules > TBASS (Sound Module) > Channels > TBASS_ChannelSet3DPosition |
Description
Sets the 3D position of a sample, stream, or MOD music channel with 3D functionality.
Syntax
n = TBASS_ChannelSet3DPosition(hChannel, Pos, Orient, Vel)
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 |
hChannel |
Numeric |
No |
The channel handle... a HCHANNEL, HMUSIC, HSTREAM, or HRECORD. |
Pos |
pStruct |
No |
Position of the sound NULL = leave current |
Orient |
pStruct |
No |
Orientation of the sound NULL = leave current. This is automatically normalized |
Vel |
pStruct |
No |
Velocity of the sound NULL = leave current. This is only used to calculate the doppler effect, and has no effect on the sound's position. |
Remarks
Attention: pStruct parameters in this function are pointer to a UDT with the following structure:
Type TBASS_3DVECTOR
X As Single
Y As Single
Z As Single
End Type
Use VARPTR to pass a pointer to a variable structure with the above structure.
As with all 3D functions, TBASS_Apply3D must be called to apply the changes made
Restrictions
See also
Examples