# CreateListener ( parent[,rolloff_factor#][,doppler_scale#][,distance_scale#] )

# Parameters

parent - parent entity of listener. A parent entity, typically a camera, must be specified to 'carry' the listener around. rolloff_factor# (optional) - the rate at which volume diminishes with distance. Defaults to 1. doppler_scale# (optional) - the severity of the doppler effect. Defaults to 1. distance_scale# (optional) - artificially scales distances. Defaults to 1.

# Description

Creates a listener entity and returns its handle. Currently, only a single listener is supported.

# Example

; CreateListener Example
; ----------------------
Graphics3D 640,480
SetBuffer BackBuffer()
camera=CreateCamera()
PositionEntity camera,0,1,-10
light=CreateLight()
RotateEntity light,90,0,0
plane=CreatePlane()
ground_tex=LoadTexture("media/Chorme-2.bmp")
EntityTexture plane,ground_tex
cube=CreateCube()
cube_tex=LoadTexture("media/b3dlogo.jpg")
EntityTexture cube,cube_tex
PositionEntity cube,0,1,0
microphone=CreateListener(camera) ; Create listener, make it child of camera
sound=Load3DSound("media/ufo.wav") ; Load 3D sound
While Not KeyDown(1)
If KeyDown(205)=True Then TurnEntity camera,0,-1,0
If KeyDown(203)=True Then TurnEntity camera,0,1,0
If KeyDown(208)=True Then MoveEntity camera,0,0,-0.05
If KeyDown(200)=True Then MoveEntity camera,0,0,0.05
; If left mouse button hit then emit sound from cube
If MouseHit(1) = True Then EmitSound(sound,cube)
RenderWorld
Text 0,0,"Use cursor keys to move about"
Text 0,20,"Press left mouse button to make a sound be emitted from the cube"
Flip
Wend
End

Index
Click here to view the latest version of this page online