Difference between revisions of "Sound.setListenerPosition"

From GiderosMobile
m (Text replacement - "</source>" to "</syntaxhighlight>")
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
<languages />
+
'''Available since:''' Gideros 2016.10<br/>
'''<translate>Available since</translate>:''' in development<br/>
+
'''Class:''' [[Sound]]<br/>
'''<translate>Class</translate>:''' [[Special:MyLanguage/Sound|Sound]]<br/>
+
 
=== <translate>Description</translate> ===
+
=== Description ===
<translate>Sets the position of the listener in a 3D environment</translate>
+
Sets the position of the listener in a 3D environment.
<source lang="lua">
+
<syntaxhighlight lang="lua">
Sound.setListenerPosition(x,y,z,vx,vy,vz,dx,dy,dz,ux,uy,uz)
+
Sound.setListenerPosition(x,y,z,vx,vy,vz,dx,dy,dz,ux,uy,uz)
</source>
+
</syntaxhighlight>
=== <translate>Parameters</translate> ===
+
 
'''x''': (number) <translate>X coordinate of the listener</translate> <br/>
+
  '''Note''': please notice the '''dot''' instead of the column Sound'''.'''setListenerPosition(...)
'''y''': (number) <translate>Y coordinate of the listener</translate> <br/>
+
 
'''z''': (number) <translate>z coordinate of the listener</translate> '''optional'''<br/>
+
=== Parameters ===
'''vx''': (number) <translate>X component of listener's velocity</translate> '''optional'''<br/>
+
'''x''': (number) X coordinate of the listener<br/>
'''vy''': (number) <translate>Y component of listener's velocity</translate> '''optional'''<br/>
+
'''y''': (number) Y coordinate of the listener<br/>
'''vz''': (number) <translate>Z component of listener's velocity</translate> '''optional'''<br/>
+
'''z''': (number) z coordinate of the listener '''optional'''<br/>
'''dx''': (number) <translate>X component of the direction the listener is facing</translate> '''optional'''<br/>
+
'''vx''': (number) X component of listener's velocity '''optional'''<br/>
'''dy''': (number) <translate>Y component of the direction the listener is facing</translate> '''optional'''<br/>
+
'''vy''': (number) Y component of listener's velocity '''optional'''<br/>
'''dz''': (number) <translate>Z component of the direction the listener is facing</translate> '''optional'''<br/>
+
'''vz''': (number) Z component of listener's velocity '''optional'''<br/>
'''ux''': (number) <translate>X component of up direction relative to the listener</translate> '''optional'''<br/>
+
'''dx''': (number) X component of the direction the listener is facing '''optional'''<br/>
'''uy''': (number) <translate>Y component of up direction relative to the listener</translate> '''optional'''<br/>
+
'''dy''': (number) Y component of the direction the listener is facing '''optional'''<br/>
'''uz''': (number) <translate>Z component of up direction relative to the listener</translate> '''optional'''<br/>
+
'''dz''': (number) Z component of the direction the listener is facing '''optional'''<br/>
 +
'''ux''': (number) X component of up direction relative to the listener '''optional'''<br/>
 +
'''uy''': (number) Y component of up direction relative to the listener '''optional'''<br/>
 +
'''uz''': (number) Z component of up direction relative to the listener '''optional'''<br/>
 +
 
 +
=== Example ===
 +
<syntaxhighlight lang="lua">
 +
local audioScale=0.02
 +
local scrW,scrH=application:getContentWidth(),application:getContentHeight()
 +
Sound.setListenerPosition(scrW*audioScale/2,scrH*audioScale/2,0,0,0,0,0,1,0,0,0,1)
 +
 
 +
local dot1 = Bitmap.new(Texture.new("1.png"))
 +
dot1:setAnchorPoint(0.5, 0.5)
 +
 
 +
local snd1=Sound.new("1.wav")
 +
dot1.sndchn=snd1:play(0,true,true)
 +
 
 +
local dots = {dot1}
 +
 
 +
local function onTouchesBegin(event)
 +
local dot = dots[event.touch.id]
 +
if dot then
 +
stage:addChild(dot)
 +
dot:setPosition(event.touch.x, event.touch.y)
 +
dot.sndchn:setWorldPosition(event.touch.x*audioScale, event.touch.y*audioScale)
 +
dot.sndchn:setPaused(false)
 +
end
 +
end
 +
 
 +
local function onTouchesMove(event)
 +
local dot = dots[event.touch.id]
 +
if dot then
 +
dot:setPosition(event.touch.x, event.touch.y)
 +
dot.sndchn:setWorldPosition(event.touch.x*audioScale, event.touch.y*audioScale)
 +
end
 +
end
 +
 
 +
local function onTouchesEnd(event)
 +
local dot = dots[event.touch.id]
 +
if dot and stage:contains(dot) then
 +
stage:removeChild(dot)
 +
dot.sndchn:setPaused(true)
 +
end
 +
end
 +
 
 +
local function onTouchesCancel(event)
 +
local dot = dots[event.touch.id]
 +
if dot and stage:contains(dot) then
 +
stage:removeChild(dot)
 +
dot.sndchn:setPaused(true)
 +
end
 +
end
 +
 
 +
stage:addEventListener(Event.TOUCHES_BEGIN, onTouchesBegin)
 +
stage:addEventListener(Event.TOUCHES_MOVE, onTouchesMove)
 +
stage:addEventListener(Event.TOUCHES_END, onTouchesEnd)
 +
stage:addEventListener(Event.TOUCHES_CANCEL, onTouchesCancel)
 +
</syntaxhighlight>
 +
 
 +
{{Sound}}

Latest revision as of 15:31, 13 July 2023

Available since: Gideros 2016.10
Class: Sound

Description

Sets the position of the listener in a 3D environment.

Sound.setListenerPosition(x,y,z,vx,vy,vz,dx,dy,dz,ux,uy,uz)
  Note: please notice the dot instead of the column Sound.setListenerPosition(...)

Parameters

x: (number) X coordinate of the listener
y: (number) Y coordinate of the listener
z: (number) z coordinate of the listener optional
vx: (number) X component of listener's velocity optional
vy: (number) Y component of listener's velocity optional
vz: (number) Z component of listener's velocity optional
dx: (number) X component of the direction the listener is facing optional
dy: (number) Y component of the direction the listener is facing optional
dz: (number) Z component of the direction the listener is facing optional
ux: (number) X component of up direction relative to the listener optional
uy: (number) Y component of up direction relative to the listener optional
uz: (number) Z component of up direction relative to the listener optional

Example

local audioScale=0.02
local scrW,scrH=application:getContentWidth(),application:getContentHeight()
Sound.setListenerPosition(scrW*audioScale/2,scrH*audioScale/2,0,0,0,0,0,1,0,0,0,1)

local dot1 = Bitmap.new(Texture.new("1.png"))
dot1:setAnchorPoint(0.5, 0.5)

local snd1=Sound.new("1.wav")
dot1.sndchn=snd1:play(0,true,true)

local dots = {dot1}

local function onTouchesBegin(event)
	local dot = dots[event.touch.id]
	if dot then
		stage:addChild(dot)
		dot:setPosition(event.touch.x, event.touch.y)
		dot.sndchn:setWorldPosition(event.touch.x*audioScale, event.touch.y*audioScale)
		dot.sndchn:setPaused(false)
	end
end

local function onTouchesMove(event)
	local dot = dots[event.touch.id]
	if dot then
		dot:setPosition(event.touch.x, event.touch.y)
		dot.sndchn:setWorldPosition(event.touch.x*audioScale, event.touch.y*audioScale)
	end
end

local function onTouchesEnd(event)
	local dot = dots[event.touch.id]
	if dot and stage:contains(dot) then
		stage:removeChild(dot)
		dot.sndchn:setPaused(true)
	end
end

local function onTouchesCancel(event)
	local dot = dots[event.touch.id]
	if dot and stage:contains(dot) then
		stage:removeChild(dot)
		dot.sndchn:setPaused(true)
	end
end

stage:addEventListener(Event.TOUCHES_BEGIN, onTouchesBegin)
stage:addEventListener(Event.TOUCHES_MOVE, onTouchesMove)
stage:addEventListener(Event.TOUCHES_END, onTouchesEnd)
stage:addEventListener(Event.TOUCHES_CANCEL, onTouchesCancel)