JDK-4931588 : DOC: MidiChannel should specify optionality
  • Type: Bug
  • Component: client-libs
  • Sub-Component: javax.sound
  • Affected Version: 1.4.1,5.0
  • Priority: P3
  • Status: Resolved
  • Resolution: Fixed
  • OS: generic,windows_2000
  • CPU: generic,x86
  • Submitted: 2003-10-02
  • Updated: 2017-05-16
  • Resolved: 2003-10-24
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
Other
5.0 b26Fixed
Related Reports
Duplicate :  
JDK-4916365 - DOC: JCK1.5-runtime api/javax_sound/midi/... PitchBend fails
Duplicate :  
JDK-4718989 - SPEC: get/set Mono and Omni do not work
Duplicate :  
JDK-4926594 - DOC: JCK1.5-runtime api/javax_sound/midi/MidiChannel/index.html#Pressure fails
Description

Name: fb126949			Date: 10/02/2003


The MidiChannel interface specifies many methods that are not necessarily implemented by all synthesizers. Examples:

1) setMono is superseded and not available in modern Synthesizers, which couldn't leverage the extra processing power in mono mode.

2) setProgram(int, int) may fail if the Synthesizer's soundbank does not contain the specific bank.

3) PolyPressure is only available in high-end Synthesizers

4) localControl is a function for devices with built-in keyboard

In total, this request affects the following methods:

setPolyPressure
getPolyPressure
setChannelPressure
getChannelPressure
setControlChange
getController
programChange(int)
programChange(int, int)
getProgram
setPitchBend
getPitchBend
localControl
setMono
getMono
setOmni
getOmni
setMute
getMute
setSolo
getSolo


The suggested fix is to allow setXXX methods to fail and explicitely ask the user to check the success with the corresponding getXXX method.

======================================================================

###@###.### 2003-10-22
Integrated changes to Doc per CCC request 4931588.
Reviewed by Florian
Comments
CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: tiger tiger-beta FIXED IN: tiger-beta INTEGRATED IN: tiger-b26 tiger-beta
14-06-2004
PUBLIC COMMENTS MidiChannel should specify optionality
10-06-2004
EVALUATION ###@###.### 2003-10-02 Important to clarify the API. The implementation already behaves this way.
02-10-2003