W3C home > Mailing lists > Public > public-audio@w3.org > October to December 2012

[Bug 18332] Node creation method naming inconsistencies

From: <bugzilla@jessica.w3.org>
Date: Wed, 17 Oct 2012 21:40:39 +0000
To: public-audio@w3.org
Message-ID: <bug-18332-5429-rBkn1ICfOL@http.www.w3.org/Bugs/Public/>
https://www.w3.org/Bugs/Public/show_bug.cgi?id=18332

--- Comment #5 from Chris Rogers <crogers@google.com> ---
(In reply to comment #4)
> (In reply to comment #3)
> > Now that 17407 is resolved, how do the two method name-changes sound?
> 
> Given your suggestion, we'd get:
> 
> createBufferSource -> AudioBufferSourceNode
> createMediaElementSource -> MediaElementAudioSourceNode
> createMediaStreamSource -> MediaStreamAudioSourceNode
> createScriptProcessor -> ScriptProcessorNode
> createAnalyser -> AnalyserNode
> createGain -> GainNode
> createDelay -> DelayNode
> createBiquadFilter -> BiquadFilterNode
> createWaveShaper -> WaveShaperNode
> createPanner -> PannerNode
> createConvolver -> ConvolverNode
> createChannelSplitter -> ChannelSplitterNode
> createChannelMerger -> ChannelMergerNode
> createDynamicsCompressor -> DynamicsCompressorNode
> createOscillator -> OscillatorNode
> 
> This looks very intuitive to me. The only thing sticking out here are the
> three first nodes, where "Audio" is somehow in the node name (which seems
> right IMO), but not in the create* method name.
> 
> I don't have any objections to that (shorter names = good thing™), other
> than the possible loss of distinction between Audio/Video Media sources that
> you mentioned in Bug 17407. Any thoughts?

My thinking here was that the create() methods are in the "namespace" of the
AudioContext, and thus it's implied that we're dealing with audio, and the
clarity gained by the shorter name was worth it.  By contrast, the node/class
names are in the global namespace and so I wanted to make that distinction.

-- 
You are receiving this mail because:
You are the QA Contact for the bug.
Received on Wednesday, 17 October 2012 21:40:40 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:50:03 UTC