ISSUE-52: (Bugzilla 17344) noteOn, noteGrainOn and noteOff naming
NoteOnOffNaming
(Bugzilla 17344) noteOn, noteGrainOn and noteOff naming
- State:
- CLOSED
- Product:
- Web Audio API
- Raised by:
- Philip Jägenstedt
- Opened on:
- 2012-05-15
- Description:
- The naming convention is unfortunate as the connection to a note is not clear. For a game sound effects or UI sound effects, this terminology is fairly obscure.
The noteGrainOn grainDuration parameter does not seem to serve any purpose given that noteOff also exists.
Suggested simplification:
void play(optional double when, optional double offset, optional double duration);
void stop(optional double when);
Note that the special meaning of 0 in note* is not needed if the arguments are optional. - Related Actions Items:
- No related actions
- Related emails:
- [web-audio-api] (NoteOnOffNaming): noteOn, noteGrainOn and noteOff naming (#155) (from notifications@github.com on 2013-09-11)
- Re: Summary of issues (from crogers@google.com on 2012-05-22)
- Summary of issues (from mage@opera.com on 2012-05-22)
- Audio-ISSUE-52 (NoteOnOffNaming): noteOn, noteGrainOn and noteOff naming [Web Audio API] (from sysbot+tracker@w3.org on 2012-05-15)
Related notes:
Agreed that the names are unfortunate, also because "note-on" and "note-off" have specific connotations in MIDI which are not the same as in this spec. So it will be a good idea to change the names.
We have already discussed in the tele-conferences (and in much earlier discussions in the mailing list) that start() and stop() would be good names.
I still believe the "duration" is useful, but we can discuss further.
I'm OK with making special meaning of 0 go away --- it used to be this way, but for some reason somebody changed it in WebKit
Under discussion. OPEN.
Olivier Thereaux, 30 May 2012, 20:28:12[MikeSmith]: https://www.w3.org/Bugs/Public/show_bug.cgi?id=17344
5 Jun 2012, 13:52:53Display change log
