JDK-4912739 : SPEC: DataLine.Info.getFormats() should document NOT_SPECIFIED
  • Type: Bug
  • Component: client-libs
  • Sub-Component: javax.sound
  • Affected Version: 5.0
  • Priority: P3
  • Status: Resolved
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2003-08-26
  • Updated: 2017-05-16
  • Resolved: 2003-11-07
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.
5.0 b28Fixed
Name: fb126949			Date: 08/26/2003

DataLine.Info.getFormats() returns an array of audio formats that are supported by the data line. However, some lines support a very wide range or any value for some parameters of the audio format, like lines that support any sample rate from 10Hz to 200KHz. In such cases, the current implementation sets the respective parameter (and the dependent parameters, if any) to AudioSystem.NOT_SPECIFIED. 

The method's documentation should mention that fields in the audio format may be set to NOT_SPECIFIED and what it means.

In the long run, a consistent concept for specifying ranges should be added to the Java Sound API.

###@###.### 2003-11-03
checked in fix

CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: tiger tiger-beta FIXED IN: tiger-beta INTEGRATED IN: tiger-b28 tiger-beta

PUBLIC COMMENTS ataLine.Info.getFormats() should document NOT_SPECIFIED

EVALUATION ###@###.### 2003-08-26 Fixing this helps reducing the confusion among developers where and when AudioSystem.NOT_SPECIFIED can be used.