United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
Bug ID: JDK-4931588 DOC: MidiChannel should specify optionality
JDK-4931588 : DOC: MidiChannel should specify optionality

Details
Type:
Bug
Submit Date:
2003-10-02
Status:
Resolved
Updated Date:
2004-01-15
Project Name:
JDK
Resolved Date:
2003-10-24
Component:
client-libs
OS:
generic,windows_2000
Sub-Component:
javax.sound
CPU:
x86,generic
Priority:
P3
Resolution:
Fixed
Affected Versions:
1.4.1,5.0
Fixed Versions:
5.0 (b26)

Related Reports
Duplicate:
Duplicate:
Duplicate:

Sub Tasks

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
EVALUATION


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

MidiChannel should specify optionality
                                     
2004-06-10
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



Hardware and Software, Engineered to Work Together