Plugin:MirLua/Module/m sounds: Difference between revisions

From Miranda NG
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

Other languages:

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')
Retrieved from "https://wiki.miranda-ng.org/index.php?title=Plugin:MirLua/Module/m_sounds&oldid=28690"