refactor: rename integer-samples feature to integer-decoder

Renamed the "integer-samples" feature flag to "integer-decoder" to better
reflect its purpose of controlling decoder output format rather than general
sample handling.

- Renamed feature flag in Cargo.toml
- Updated corresponding cfg attributes in source code
- Updated documentation to reflect the new feature name
- Maintains same functionality of switching between i16/f32 decoder output

This change makes the feature's purpose more explicit and matches the
component it affects.

Author: roderickvd

CHANGELOG.md

@@ -27,15 +27,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Breaking: `Sink::try_new` renamed to `connect_new` and does not return error anymore.
             `Sink::new_idle` was renamed to `new`.
 - Breaking: In the `Source` trait, the method `current_frame_len()` was renamed to `current_span_len()`.
-- Breaking: `Decoder` now outputs `f32` samples instead of `i16`.
+- Breaking: `Decoder` now outputs `f32` samples by default instead of `i16`.
+  Enable the `integer-decoder` to revert to `i16` samples.
 - The term 'frame' was renamed to 'span' in the crate and documentation.
 
 ### Fixed
 - Symphonia decoder `total_duration` incorrect value caused by conversion from `Time` to `Duration`.
 - An issue with `SignalGenerator` that caused it to create increasingly distorted waveforms
   over long run times has been corrected. (#201)
-- WAV and FLAC decoder duration calculation now calculated once and handles very large files correctly
-- Removed unwrap() calls in MP3, WAV and FLAC format detection for better error handling
+- WAV and FLAC decoder duration calculation now calculated once and handles very large files
+  correctly
+- Removed unwrap() calls in MP3, WAV, FLAC and Vorbis format detection for better error handling
 
 ### Deprecated
 - Deprecated `Sample::zero_value()` function in favor of `Sample::ZERO_VALUE` constant

Cargo.toml

@@ -30,7 +30,7 @@ default = ["playback", "flac", "vorbis", "wav", "mp3"]
 tracing = ["dep:tracing"]
 experimental = ["dep:atomic_float"]
 playback = ["dep:cpal"]
-integer-samples = []
+integer-decoder = []
 
 flac = ["claxon"]
 vorbis = ["lewton"]

src/decoder/mod.rs

@@ -31,10 +31,10 @@ mod vorbis;
 #[cfg(all(feature = "wav", not(feature = "symphonia-wav")))]
 mod wav;
 
-#[cfg(feature = "integer-samples")]
+#[cfg(feature = "integer-decoder")]
 /// Output format of the decoders.
 pub type DecoderSample = i16;
-#[cfg(not(feature = "integer-samples"))]
+#[cfg(not(feature = "integer-decoder"))]
 /// Output format of the decoders.
 pub type DecoderSample = f32;
 

src/lib.rs

@@ -142,9 +142,9 @@
 //!
 //! The "playback" feature adds support for playing audio. This feature requires the "cpal" crate.
 //!
-//! ### Feature "integer-samples"
+//! ### Feature "integer-decoder"
 //!
-//! The "integer-samples" changes the output format of the decoders to use `i16` instead of `f32`.
+//! The "integer-decoder" changes the output format of the decoders to use `i16` instead of `f32`.
 //! This is useful if you want to decode audio on an exotic, low-spec or old device that does not
 //! have hardware support for floating-point operations.
 //!