Plugin:MirLua/Module/m sounds: Difference between revisions
Jump to navigation
Jump to search
(mark translation units) |
(Marked this version for translation) |
||
Line 9: | Line 9: | ||
__TOC__ | __TOC__ | ||
<translate> | <translate> | ||
== Functions == | == Functions == <!--T:2--> | ||
</translate> | </translate> | ||
=== AddSound === | === AddSound === | ||
<translate>Registers a sound.</translate> | <translate><!--T:3--> Registers a sound.</translate> | ||
==== {{Ls|MirLua/Modules/parameters}} ==== | ==== {{Ls|MirLua/Modules/parameters}} ==== | ||
; {{nbsp|5}}''name'' {{Nobold|({{Ls|MirLua/Modules/obligatory_param}})}} | ; {{nbsp|5}}''name'' {{Nobold|({{Ls|MirLua/Modules/obligatory_param}})}} | ||
:: {{Ls|MirLua/Modules/type}}: '''string''' | :: {{Ls|MirLua/Modules/type}}: '''string''' | ||
:: <translate>Unique name.</translate> | :: <translate><!--T:4--> Unique name.</translate> | ||
; {{nbsp|5}}''description'' {{Nobold|({{Ls|MirLua/Modules/obligatory_param}})}} | ; {{nbsp|5}}''description'' {{Nobold|({{Ls|MirLua/Modules/obligatory_param}})}} | ||
:: {{Ls|MirLua/Modules/type}}: '''string''' | :: {{Ls|MirLua/Modules/type}}: '''string''' | ||
:: <translate>Description.</translate> | :: <translate><!--T:5--> Description.</translate> | ||
; {{nbsp|5}}''section'' | ; {{nbsp|5}}''section'' | ||
:: {{Ls|MirLua/Modules/type}}: '''string''' | :: {{Ls|MirLua/Modules/type}}: '''string''' | ||
:: <translate>Section name in Miranda sound settings. By default plugin name (<tvar|default_name>''MirLua''</>) is used.</translate> | :: <translate><!--T:6--> Section name in Miranda sound settings. By default plugin name (<tvar|default_name>''MirLua''</>) is used.</translate> | ||
; {{nbsp|5}}''path'' | ; {{nbsp|5}}''path'' | ||
:: {{Ls|MirLua/Modules/type}}: '''string''' | :: {{Ls|MirLua/Modules/type}}: '''string''' | ||
:: <translate>Path to sound file.</translate> | :: <translate><!--T:7--> Path to sound file.</translate> | ||
==== {{Ls|MirLua/Modules/result}} ==== | ==== {{Ls|MirLua/Modules/result}} ==== | ||
{{nbsp|5}}{{Ls|MirLua/Modules/type}}: '''boolean''' | {{nbsp|5}}{{Ls|MirLua/Modules/type}}: '''boolean''' | ||
{{nbsp|5}}<translate>Returns <tvar|return_on_success>'''true'''</> if sound was registered successfully, otherwise <tvar|return_on_fail>'''false'''</>.</translate> | {{nbsp|5}}<translate><!--T:8--> Returns <tvar|return_on_success>'''true'''</> if sound was registered successfully, otherwise <tvar|return_on_fail>'''false'''</>.</translate> | ||
==== {{Ls|MirLua/Modules/example}} ==== | ==== {{Ls|MirLua/Modules/example}} ==== | ||
Line 40: | Line 40: | ||
=== PlaySound === | === PlaySound === | ||
<translate>Plays sound by its unique name.</translate> | <translate><!--T:9--> Plays sound by its unique name.</translate> | ||
==== {{Ls|MirLua/Modules/parameters}} ==== | ==== {{Ls|MirLua/Modules/parameters}} ==== | ||
; {{nbsp|5}}''name'' {{Nobold|({{Ls|MirLua/Modules/obligatory_param}})}} | ; {{nbsp|5}}''name'' {{Nobold|({{Ls|MirLua/Modules/obligatory_param}})}} | ||
:: {{Ls|MirLua/Modules/type}}: '''string''' | :: {{Ls|MirLua/Modules/type}}: '''string''' | ||
:: <translate>Unique name.</translate> | :: <translate><!--T:10--> Unique name.</translate> | ||
==== {{Ls|MirLua/Modules/result}} ==== | ==== {{Ls|MirLua/Modules/result}} ==== | ||
{{nbsp|5}}{{Ls|MirLua/Modules/type}}: '''boolean''' | {{nbsp|5}}{{Ls|MirLua/Modules/type}}: '''boolean''' | ||
{{nbsp|5}}<translate>Returns <tvar|return_on_success>'''true'''</> if sound was played successfully, otherwise <tvar|return_on_fail>'''false'''</>.</translate> | {{nbsp|5}}<translate><!--T:11--> Returns <tvar|return_on_success>'''true'''</> if sound was played successfully, otherwise <tvar|return_on_fail>'''false'''</>.</translate> | ||
==== {{Ls|MirLua/Modules/example}} ==== | ==== {{Ls|MirLua/Modules/example}} ==== | ||
Line 56: | Line 56: | ||
=== PlayFile === | === PlayFile === | ||
<translate>Plays sound from file.</translate> | <translate><!--T:12--> Plays sound from file.</translate> | ||
==== {{Ls|MirLua/Modules/parameters}} ==== | ==== {{Ls|MirLua/Modules/parameters}} ==== | ||
; {{nbsp|5}}''path'' {{Nobold|({{Ls|MirLua/Modules/obligatory_param}})}} | ; {{nbsp|5}}''path'' {{Nobold|({{Ls|MirLua/Modules/obligatory_param}})}} | ||
:: {{Ls|MirLua/Modules/type}}: '''string''' | :: {{Ls|MirLua/Modules/type}}: '''string''' | ||
:: <translate>Path to file.</translate> | :: <translate><!--T:13--> Path to file.</translate> | ||
==== {{Ls|MirLua/Modules/result}} ==== | ==== {{Ls|MirLua/Modules/result}} ==== | ||
{{nbsp|5}}{{Ls|MirLua/Modules/type}}: '''boolean''' | {{nbsp|5}}{{Ls|MirLua/Modules/type}}: '''boolean''' | ||
{{nbsp|5}}<translate>Returns <tvar|return_on_success>'''true'''</> if sound was played successfully, otherwise <tvar|return_on_fail>'''false'''</>.</translate> | {{nbsp|5}}<translate><!--T:14--> Returns <tvar|return_on_success>'''true'''</> if sound was played successfully, otherwise <tvar|return_on_fail>'''false'''</>.</translate> | ||
==== {{Ls|MirLua/Modules/example}} ==== | ==== {{Ls|MirLua/Modules/example}} ==== | ||
{{Content:MirLua/Example|code=sounds.PlayFile('c:\\lambada.wav')}} | {{Content:MirLua/Example|code=sounds.PlayFile('c:\\lambada.wav')}} |
Revision as of 18:25, 15 April 2018
Allows you to work with sounds.
Include module:: local sounds = require('m_sounds')
Functions
AddSound
Registers a sound.
Parameters
- name (Translations:L10n:MirLua/Modules/obligatory param/en)
-
- Type:: string
- Unique name.
- description (Translations:L10n:MirLua/Modules/obligatory param/en)
-
- Type:: string
- Description.
- section
-
- Type:: string
- Section name in Miranda sound settings. By default plugin name (MirLua) is used.
- path
-
- Type:: string
- Path to sound file.
Result
Type:: boolean
Returns true if sound was registered successfully, otherwise false.
Example
local hIcon = sounds.AddSound('soundUniqueName', 'My super icon')
PlaySound
Plays sound by its unique name.
Parameters
- name (Translations:L10n:MirLua/Modules/obligatory param/en)
-
- Type:: string
- Unique name.
Result
Type:: boolean
Returns true if sound was played successfully, otherwise false.
Example
sounds.PlaySound('soundUniqueName')
PlayFile
Plays sound from file.
Parameters
- path (Translations:L10n:MirLua/Modules/obligatory param/en)
-
- Type:: string
- Path to file.
Result
Type:: boolean
Returns true if sound was played successfully, otherwise false.
Example
sounds.PlayFile('c:\\lambada.wav')