addMusicEventHandler: Difference between revisions

Revision as of 14:45, 24 November 2021

0.50

LELocal

Hover & click on the images for description

Description

Description:: Adds playMusic event handler. Returns id of the handler or -1 when failed. Like addMissionEventHandler, the music event handler is attached to the mission.
Groups:: Event Handlers Sounds

Syntax

Syntax:

addMusicEventHandler [type, function]

Parameters:

type: String - "MusicStart" or "MusicStop"

function: String or Code - passed params array is [musicClassname, eventHandlerId] where:

musicClassname: String - CfgMusic class name
eventHandlerId: Number - event handler id

params ["_musicClassname", "_ehId"];

Return Value:

Number - event handler id

Examples

Example 1:: private _ehID = addMusicEventHandler ["MusicStart", { hint str _this }];
Example 2:: private _ehID = addMusicEventHandler ["MusicStop", { hint str _this }];

Additional Information

See also:: setMusicEventHandler playMusic removeMusicEventHandler removeAllMusicEventHandlers

Notes

: Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

Druid - c

Posted on Mar 04, 2013 - 13:30 (UTC)

There are these two types at this time:

MusicStart - It is triggered when the music is started (command playMusic). In variable _this is stored class name from CfgMusic.
MusicStop - It is triggered when the music is ended (command playMusic). In variable _this is stored class name from CfgMusic.

@@ Line 3: / Line 3: @@
 |game1= arma3
 |version1= 0.50
+|eff= local
 |gr1= Event Handlers
@@ Line 8: / Line 10: @@
 |gr2= Sounds
-|descr= Adds [[playMusic]] event handler. Returns id of the handler or -1 when failed. Just like [[addMissionEventHandler]], music EH is also attached to the mission.
+|descr= Adds [[playMusic]] event handler. Returns id of the handler or -1 when failed. Like [[addMissionEventHandler]], the music event handler is attached to the mission.
 |s1= [[addMusicEventHandler]] [type, function]
-|p1= [type, function]: [[Array]]
+|p1= type: [[String]] - "MusicStart" or "MusicStop"
-|p2= type: [[String]] - "MusicStart" or "MusicStop"
+|p2= function: [[String]] or [[Code]] - passed params array is [musicClassname, eventHandlerId] where:
+* musicClassname: [[String]] - [[Description.ext#Music|CfgMusic]] class name
+* eventHandlerId: [[Number]] - event handler id
+<syntaxhighlight lang="cpp">params ["_musicClassname", "_ehId"];</syntaxhighlight>
-|p3= function: [[String]] or [[Code]] - Passed params array:
+|r1= [[Number]] - event handler id
-* 0: [[Description.ext#Music|CfgMusic]] class name
-* 1: this event handler id
-|r1= [[Number]] - Event handler id
+|x1= <code>[[private]] _ehID = [[addMusicEventHandler]] ["MusicStart", { [[hint]] [[str]] _this }];</code>
-|x1= <code>_ehID = [[addMusicEventHandler]] ["MusicStart", {[[hint]] [[str]] _this}];</code>
+|x2= <code>[[private]] _ehID = [[addMusicEventHandler]] ["MusicStop", { [[hint]] [[str]] _this }];</code>
-|x2= <code>_ehID = [[addMusicEventHandler]] ["MusicStop", {[[hint]] [[str]] _this}];</code>
 |seealso= [[setMusicEventHandler]], [[playMusic]], [[removeMusicEventHandler]], [[removeAllMusicEventHandlers]]
 }}
-<dl class="command_description">
+{{Note
+|user= Druid
-<dt><dt>
+|timestamp= 20130304133000
-<dd class="notedate">Posted on March 4, 2013 - 13:30</dd>
+|text= There are these two types at this time:
-<dt class="note">[[User:Druid|Druid]]</dt>
+* '''MusicStart''' - It is triggered when the music is started (command [[playMusic]]). In variable _this is stored class name from [[Description.ext#Music|CfgMusic]].
-<dd class="note">There are these two types at this time:<br>
+* '''MusicStop''' - It is triggered when the music is ended (command [[playMusic]]). In variable _this is stored class name from [[Description.ext#Music|CfgMusic]].
-'''MusicStart''' - It is triggered when the music is started (command [[playMusic]]). In variable _this is stored class name from [[Description.ext#Music|CfgMusic]].<br>
+}}
-'''MusicStop''' - It is triggered when the music is ended (command [[playMusic]]). In variable _this is stored class name from [[Description.ext#Music|CfgMusic]].
-</dl>