PL/playSound3D - Revision history

GabWas: GabWas moved page PL/PlaySound3D to PL/playSound3D

2016-07-21T11:14:56Z

GabWas moved page PL/PlaySound3D to PL/playSound3D

← Older revision

Revision as of 11:14, 21 July 2016

GabWas: Tłumaczenie napisane od początku, na podstawie wersji angielskiej (poprzednia edycja - missclick).

2016-07-21T10:16:32Z

Tłumaczenie napisane od początku, na podstawie wersji angielskiej (poprzednia edycja - missclick).

← Older revision		Revision as of 10:16, 21 July 2016
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{Client function}}		{{PL/Client function}}
	~~Creates a [[sound]]~~ [[element]] ~~in the GTA world and plays it immediately after creation for the local player. [[setElementPosition]] can be used to move the~~ [[sound]] ~~element around after it has been created~~. ~~Remember to use~~ [[~~setElementDimension~~]] ~~after creating the sound to play it outside of dimension 0~~.~~<br />~~		Funkcja ta tworzy [[element]] [[sound\|dźwięku]] oraz odtwarza go dla lokalnego gracza, od razu po wywołaniu funkcji. Jeżeli po stworzeniu dźwięku chcesz zmienić jego pozycję, skorzystaj z funkcji [[setElementPosition]].
	~~<br />~~		Akutalnie wspierane formaty audio to MP3, WAV, OGG, RIFF, MOD, XM, IT oraz S3M.
	~~'''Note:''' The only supported~~ audio ~~formats are~~ MP3, WAV, OGG, RIFF, MOD, XM, IT ~~and~~ S3M.		{{PL/Note\|Ze względu na wydajność, podczas korzystania z funkcji playSound do efektów (np. dźwięki strzelania), zalecana jest konwersja pliku audio z np. MP3 (stereo) do WAV (mono) z częstotliwością 22050 Hz lub niższą. Warto również dodać limit odtwarzania dźwięku np. raz na 50ms.}}
	{{Note\|~~For performance reasons~~, ~~when using playSound3D for effects that will be played lots~~ (~~i.e~~. ~~weapon fire~~), ~~it is recommend that you convert your~~ audio ~~file to a one channel~~ (mono) ~~WAV with sample rate of~~ 22050 Hz ~~or less~~. ~~Also consider adding a~~ limit ~~on how often the effect can be played e.g~~. ~~once every~~ 50ms.}}		==Składnia==
	==~~Syntax~~==
	<syntaxhighlight lang="lua">element playSound3D ( string soundPath, float x, float y, float z, [ bool looped = false, bool throttled = true ] )</syntaxhighlight>		<syntaxhighlight lang="lua">element playSound3D ( string soundPath, float x, float y, float z, [ bool looped = false, bool throttled = true ] )</syntaxhighlight>
	{{OOP\|\|[[Sound\|Sound3D]]}}		{{OOP\|\|[[Sound\|Sound3D]]}}
	===~~Required Arguments~~===		===Wymagane argumenty===
	*'''soundPath:''' ~~the~~ [[filepath]] ~~to the sound file you want to play~~. ~~(Sound file has to be predefined in the~~ [[meta.xml]] ~~file with~~ <file /> ~~tag~~. ~~And also can use url instead of [[filepath]] )~~		*'''soundPath:''' [[filepath\|Ścieżka]] lub adres URL do pliku dźwiękowego, który chcesz odtworzyć.
	*'''x:''' ~~a [[float]]ing point number representing the~~ X ~~coordinate on the map~~.		ⓘ Pliki odtwarzane ze ścieżki, muszą być wcześniej zapisane w pliku [[PL/meta.xml\|meta.xml]] korzystając z tagu <file />.
	*'''y:''' ~~a [[float]]ing point number representing the~~ Y ~~coordinate on the map~~.		*'''x:''' Liczba zmiennoprzecinkowa określająca współrzędną X dźwięku na mapie.
	*'''z:''' ~~a [[float]]ing point number representing the~~ Z ~~coordinate on the map~~.		*'''y:''' Liczba zmiennoprzecinkowa określająca współrzędną Y dźwięku na mapie.
			*'''z:''' Liczba zmiennoprzecinkowa określająca współrzędną Z dźwięku na mapie.

	===~~Optional Arguments~~===		===Opcjonalne argumenty===
	{{OptionalArg}}		{{PL/OptionalArg}}
	*'''looped:''' A [[~~boolean~~]] ~~representing whether the sound will be looped~~. ~~To loop the sound~~, ~~use~~ ''true''.		*'''looped:''' [[Boolean]] decydujący o tym, czy dźwięk ma zostać zapętlony. Aby tak się stało, użyj ''true''. Domyślnie ''false''.
			ⓘ Zapętlanie nie jest możliwe w przypadku stream'ów (np. radio).
	{{New feature/item\|3.0150\|1.5\|\|		{{New feature/item\|3.0150\|1.5\|\|
	*'''throttled:''' a [[~~boolean~~]] ~~representing whether the sound will be throttled (i~~.~~e. given reduced download bandwidth)~~. ~~To throttle the sound, use~~ ''true''. ~~Sounds will be throttled per default and only for URLs~~.		*'''throttled:''' [[Boolean]] decydujący o tym, czy dźwięk z adresu URL ma być odtwarzany z niską przepustowością łącza. Aby tak się stało, użyj ''true''. Domyślnie ''true''.
			ⓘ Odtwarzanie z niską przepustowością łącza dotyczy tylko plików odtwarzanych z adresów URL.
	}}		}}

	===~~Returns~~===		===Wynik===
	~~Returns a~~ [[~~sound~~]] [[~~element~~]] ~~if the sound was successfully created,~~ ''false'' ~~otherwise~~.		Zwraca [[element]] [[sound\|dźwięku]] jeżeli został on pomyślnie stworzony. W przeciwnym wypadku zwraca ''false''.

	==~~Example~~==		==Przykłady==
	~~This example creates a looping sound within a pizza shop. The pizza shop is in san fierro near pier 69~~		<section name="Przykład nr 1" class="client" show="true" >
	<section name="~~Example~~" class="client" show="true">		Ten przykład odtwarza radio RMF MAXXX w okolicach Grove Street.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function ~~onResourceStart~~()		function radioNaGrove ( ) -- tworzymy funkcję odpowiadającą za odtwarzanie się radia
	local ~~sound~~ = playSound3D(~~"sounds~~/~~song~~.~~mp3"~~, ~~373~~.14, -~~125~~.21, ~~1001, true~~)		local radio = playSound3D( 'http://files.kusmierz.be/rmf/rmfmaxxx.pls', 2498, -1659, 12 ) -- tworzymy dźwięk...
			setSoundMaxDistance( radio, 100 ) -- ...oraz zmieniamy jego odległość, na którą można go będzie usłyszeć (opcjonalne)
	end		end
	addEventHandler("onClientResourceStart", ~~resourceRoot, onResourceStart~~)		addEventHandler ( "onClientResourceStart", getResourceRootElement(), radioNaGrove ) -- na koniec nie zapominamy o eventHandlerze
	~~</syntaxhighlight>~~
	~~</section>~~
	~~This example play internet radio in groove street.~~
	~~<section name="Example 2" class="client" show="true" >~~
	~~<syntaxhighlight lang="lua">~~
	~~addEventHandler( 'onClientResourceStart', resourceRoot~~,
	~~function(~~ )
	~~local uSound = playSound3D( 'http://193.34.51.25:80', 2498,~~ -~~1659, 12 )~~
	~~setSoundMaxDistance( uSound, 100 )~~
	~~end~~
	)
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>

	==~~See Also~~==		<br/>
			''Autor: [[User:GabWas\|GabWas]]; utworzono: 12:16, 21 Lip 2016 (CEST)''
			<br/>''Author: [[User:GabWas\|GabWas]]; created: 10:16, 21 Jul 2016 (UTC)''

			==Zobacz również==
	{{Client_audio_functions}}		{{Client_audio_functions}}
			[[en:playSound3D]]
	[[AR:playSound3D]]		[[AR:playSound3D]]
	[[DE:playSound3D]]		[[DE:playSound3D]]
	[[RU:playSound3D]]		[[RU:playSound3D]]

GabWas at 09:24, 21 July 2016

2016-07-21T09:24:33Z

← Older revision		Revision as of 09:24, 21 July 2016
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{Client function}}		{{Client function}}
	~~Tworzy element~~ [[~~dźwięku~~]] ~~w świecie~~ GTA ~~i odtwarza go po stworzeniu go dla gracza lokalnego~~. ~~Funkcja~~ [[setElementPosition]] ~~może być użyta by przenieść~~ [[~~dźwięk~~]] ~~po tym, jak został on stworzony~~. ~~Zapamiętaj by użyć~~ [[setElementDimension]] ~~jeśli chcesz by dźwięk grał w innym wymiarze niż~~ 0.<br />		Creates a [[sound]] [[element]] in the GTA world and plays it immediately after creation for the local player. [[setElementPosition]] can be used to move the [[sound]] element around after it has been created. Remember to use [[setElementDimension]] after creating the sound to play it outside of dimension 0.<br />
			<br />
			'''Note:''' The only supported audio formats are MP3, WAV, OGG, RIFF, MOD, XM, IT and S3M.
			{{Note\|For performance reasons, when using playSound3D for effects that will be played lots (i.e. weapon fire), it is recommend that you convert your audio file to a one channel (mono) WAV with sample rate of 22050 Hz or less. Also consider adding a limit on how often the effect can be played e.g. once every 50ms.}}
			==Syntax==
			<syntaxhighlight lang="lua">element playSound3D ( string soundPath, float x, float y, float z, [ bool looped = false, bool throttled = true ] )</syntaxhighlight>
			{{OOP\|\|[[Sound\|Sound3D]]}}
			===Required Arguments===
			*'''soundPath:''' the [[filepath]] to the sound file you want to play. (Sound file has to be predefined in the [[meta.xml]] file with <file /> tag. And also can use url instead of [[filepath]] )
			*'''x:''' a [[float]]ing point number representing the X coordinate on the map.
			*'''y:''' a [[float]]ing point number representing the Y coordinate on the map.
			*'''z:''' a [[float]]ing point number representing the Z coordinate on the map.

	~~'''Notatka:''' Jedyne wspierane formaty to: MP3, WAV, OGG, RIFF, MOD, XM, IT i S3M.~~		===Optional Arguments===



	==~~Składnia~~==
	~~<syntaxhighlight lang="lua">element playSound3D ( string link/ścieżka do pliku, pozycja x, pozycja y, pozycja z, [ bool zapętlony = false ] )</syntaxhighlight>~~




	~~===Wymagane argumenty ===~~
	*'''link/ścieżka do pliku:''' Link lub ścieżka do pliku który chcesz odtwarzać. (Pliki muszą być zdefiniowane w [[meta.xml]] pomiędzy tagami <file />. Możesz użyć także URL. )
	*'''x:''' Pozycja X na mapie na której ma grać dźwięk.
	*'''y:''' Pozycja Y na mapie na której ma grać dźwięk.
	*'''z:''' Pozycja Z na mapie na której ma grać dźwięk.


	~~===Opcjonalne argumenty~~===
	{{OptionalArg}}		{{OptionalArg}}
	*'''~~zapętlony~~:''' ~~Wartość typu~~ [[boolean]] ~~reprezentująca~~, ~~czy dźwięk ma być zapętlany~~. ~~By zapętlić dźwięk~~, ~~użyj~~ ''true''.		*'''looped:''' A [[boolean]] representing whether the sound will be looped. To loop the sound, use ''true''.
			{{New feature/item\|3.0150\|1.5\|\|
			*'''throttled:''' a [[boolean]] representing whether the sound will be throttled (i.e. given reduced download bandwidth). To throttle the sound, use ''true''. Sounds will be throttled per default and only for URLs.
			}}

			===Returns===
			Returns a [[sound]] [[element]] if the sound was successfully created, ''false'' otherwise.

			==Example==
	~~===Zwracane argumenty===~~		This example creates a looping sound within a pizza shop. The pizza shop is in san fierro near pier 69
	~~Zwraca element [[dźwięku]] jeśli zostanie on poprawnie stworzony, lub ''false'' jeśli nie zostanie on poprawnie stworzony.~~		<section name="Example" class="client" show="true">




	==~~Przykład~~==
	~~Ten przykład tworzy zapętlony dźwięk w pizzeri~~. ~~Pizzeria jest umiejscowiona w San Fierro nie daleko Pier~~ 69
	<section name="~~Przykład~~" class="client" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function onResourceStart()		function onResourceStart()
	local sound = playSound3D("sounds/song.mp3", 373.14, -125.21, 1001, true)		local sound = playSound3D("sounds/song.mp3", 373.14, -125.21, 1001, true)
	end		end
	addEventHandler("onClientResourceStart", ~~getResourceRootElement(getThisResource())~~, onResourceStart)		addEventHandler("onClientResourceStart", resourceRoot, onResourceStart)
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>
			This example play internet radio in groove street.
			<section name="Example 2" class="client" show="true" >


	~~Ten przykład odtwarza~~ radio ~~internetowe na Grove Street~~.
	<section name="~~Przykład~~ 2" class="client" show="true" >
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	addEventHandler( 'onClientResourceStart', resourceRoot,		addEventHandler( 'onClientResourceStart', resourceRoot,
Line 58:		Line 46:
	</section>		</section>

			==See Also==
	==~~Zobacz także~~==
	{{Client_audio_functions}}		{{Client_audio_functions}}
	[[AR:playSound3D]]		[[AR:playSound3D]]
	[[DE:playSound3D]]		[[DE:playSound3D]]
	[[RU:playSound3D]]		[[RU:playSound3D]]

ThePiotrek at 18:39, 25 July 2014

2014-07-25T18:39:33Z

← Older revision		Revision as of 18:39, 25 July 2014
Line 3:		Line 3:
	Tworzy element [[dźwięku]] w świecie GTA i odtwarza go po stworzeniu go dla gracza lokalnego. Funkcja [[setElementPosition]] może być użyta by przenieść [[dźwięk]] po tym, jak został on stworzony. Zapamiętaj by użyć [[setElementDimension]] jeśli chcesz by dźwięk grał w innym wymiarze niż 0.<br />		Tworzy element [[dźwięku]] w świecie GTA i odtwarza go po stworzeniu go dla gracza lokalnego. Funkcja [[setElementPosition]] może być użyta by przenieść [[dźwięk]] po tym, jak został on stworzony. Zapamiętaj by użyć [[setElementDimension]] jeśli chcesz by dźwięk grał w innym wymiarze niż 0.<br />

	'''~~Note~~:''' Jedyne wspierane formaty to: MP3, WAV, OGG, RIFF, MOD, XM, IT i S3M.		'''Notatka:''' Jedyne wspierane formaty to: MP3, WAV, OGG, RIFF, MOD, XM, IT i S3M.

ThePiotrek: Created page with "NOTOC {{Client function}} Tworzy element dźwięku w świecie GTA i odtwarza go po stworzeniu go dla gracza lokalnego. Funkcja setElementPosition może być użyt..."

2014-07-25T18:38:56Z

Created page with "__NOTOC__ {{Client function}} Tworzy element dźwięku w świecie GTA i odtwarza go po stworzeniu go dla gracza lokalnego. Funkcja setElementPosition może być użyt..."

New page

__NOTOC__
{{Client function}}
Tworzy element [[dźwięku]] w świecie GTA i odtwarza go po stworzeniu go dla gracza lokalnego. Funkcja [[setElementPosition]] może być użyta by przenieść [[dźwięk]] po tym, jak został on stworzony. Zapamiętaj by użyć [[setElementDimension]] jeśli chcesz by dźwięk grał w innym wymiarze niż 0.<br />

'''Note:''' Jedyne wspierane formaty to: MP3, WAV, OGG, RIFF, MOD, XM, IT i S3M.

==Składnia==
<syntaxhighlight lang="lua">element playSound3D ( string link/ścieżka do pliku, pozycja x, pozycja y, pozycja z, [ bool zapętlony = false ] )</syntaxhighlight>

===Wymagane argumenty ===
*'''link/ścieżka do pliku:''' Link lub ścieżka do pliku który chcesz odtwarzać. (Pliki muszą być zdefiniowane w [[meta.xml]] pomiędzy tagami <file />. Możesz użyć także URL. )
*'''x:''' Pozycja X na mapie na której ma grać dźwięk.
*'''y:''' Pozycja Y na mapie na której ma grać dźwięk.
*'''z:''' Pozycja Z na mapie na której ma grać dźwięk.

===Opcjonalne argumenty===
{{OptionalArg}}
*'''zapętlony:''' Wartość typu [[boolean]] reprezentująca, czy dźwięk ma być zapętlany. By zapętlić dźwięk, użyj ''true''.

===Zwracane argumenty===
Zwraca element [[dźwięku]] jeśli zostanie on poprawnie stworzony, lub ''false'' jeśli nie zostanie on poprawnie stworzony.

==Przykład==
Ten przykład tworzy zapętlony dźwięk w pizzeri. Pizzeria jest umiejscowiona w San Fierro nie daleko Pier 69
<section name="Przykład" class="client" show="true">
<syntaxhighlight lang="lua">
function onResourceStart()
local sound = playSound3D("sounds/song.mp3", 373.14, -125.21, 1001, true)
end
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()), onResourceStart)
</syntaxhighlight>
</section>

Ten przykład odtwarza radio internetowe na Grove Street.
<section name="Przykład 2" class="client" show="true" >
<syntaxhighlight lang="lua">
addEventHandler( 'onClientResourceStart', resourceRoot,
function( )
local uSound = playSound3D( 'http://193.34.51.25:80', 2498, -1659, 12 )
setSoundMaxDistance( uSound, 100 )
end
)
</syntaxhighlight>
</section>

==Zobacz także==
{{Client_audio_functions}}
[[AR:playSound3D]]
[[DE:playSound3D]]
[[RU:playSound3D]]

PL/playSound3D - Revision history

GabWas: GabWas moved page PL/PlaySound3D to PL/playSound3D

GabWas: Tłumaczenie napisane od początku, na podstawie wersji angielskiej (poprzednia edycja - missclick).

GabWas at 09:24, 21 July 2016

ThePiotrek at 18:39, 25 July 2014

ThePiotrek: Created page with "__NOTOC__ {{Client function}} Tworzy element dźwięku w świecie GTA i odtwarza go po stworzeniu go dla gracza lokalnego. Funkcja setElementPosition może być użyt..."

ThePiotrek: Created page with "NOTOC {{Client function}} Tworzy element dźwięku w świecie GTA i odtwarza go po stworzeniu go dla gracza lokalnego. Funkcja setElementPosition może być użyt..."