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 Availabitlity Release.

To download the current JDK release, click here.
Other
5.0 b26Fixed
Related Reports
Duplicate :  
Duplicate :  
Duplicate :  
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
2004-06-14

PUBLIC COMMENTS MidiChannel should specify optionality
2004-06-10

EVALUATION ###@###.### 2003-10-02 Important to clarify the API. The implementation already behaves this way.
2003-10-02