Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Visualizer: update docs for the RMS measurements"

Browse Source
This commit is contained in:
Mikhail Naganov
2022-04-20 17:30:20 +00:00
committed by Android (Google) Code Review
parent be6d4100b2 a1f0113d79
commit aca85d418a
1 changed files with 12 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
media/java/android/media/audiofx/Visualizer.java
View File

@@ -110,10 +110,18 @@ public class Visualizer {
public static final int MEASUREMENT_MODE_NONE = 0;
/**
* Defines a measurement mode which computes the peak and RMS value in mB, where 0mB is the
* maximum sample value, and -9600mB is the minimum value.
* Values for peak and RMS can be retrieved with
* {@link #getMeasurementPeakRms(MeasurementPeakRms)}.
* Defines a measurement mode which computes the peak and RMS value in mB below the
* "full scale", where 0mB is normally the maximum sample value (but see the note
* below). Minimum value depends on the resolution of audio samples used by the audio
* framework. The value of -9600mB is the minimum value for 16-bit audio systems and
* -14400mB or below for "high resolution" systems. Values for peak and RMS can be
* retrieved with {@link #getMeasurementPeakRms(MeasurementPeakRms)}.
*
* <p class=note><strong>Note:</strong> when Visualizer effect is attached to the
* global session (with session ID 0), it is possible to observe RMS peaks higher than
* 0 dBFS, for example in the case when there are multiple audio sources playing
* simultaneously. In this case {@link #getMeasurementPeakRms(MeasurementPeakRms)}
* method can return a positive value.
*/
public static final int MEASUREMENT_MODE_PEAK_RMS = 1 << 0;