rob
/
cpal
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
cpal/CHANGELOG.md

49 lines
2.0 KiB
Markdown
Raw Normal View History

Publish 0.5.0 (#169)
2017-10-21 07:25:24 +00:00
# Unreleased
Publish 0.8 for new Device and Stream API. Update CHANGELOG. (#209)
2018-02-15 07:47:43 +00:00
# Version 0.8.0 (2018-02-15)
Update to a more general Device and Stream API. Add support for input streams (E.g. microphone). Add default format methods. (#201) * Update to a more general Device and Stream API This update prepares for adding input stream support by removing the `Endpoint` type (which only supports output streams) in favour of a more general `Device` type which may support any number of input or output streams. Previously discussed at #117. The name `Voice` has been replaced with the more ubiquitous name `Stream`. See #118 for justification. Also introduces a new `StreamData` which is now passed to the `EventLoop::run` callback rather than the `UnknownTypeBuffer`. `StreamData` allows for passing either `Input` data to be read, or `Output` data to be written. The `beep.rs` example has been updated for the API changes. None of the backends have been updated for this API change yet. Backends will be updated in the following commits. Closes #117. Closes #118. * Update ALSA backend for new `Device` and `Stream` API. * Update wasapi backend for new `Device` and `Stream` API. * Update enumerate.rs example for new `Device` and `Stream` API. * Update coreaudio backend for new `Device` and `Stream` API. * Fix lib doc tests for Device and Stream API update * Update emscripten backend for new `Device` and `Stream` API. * Update null backend for new `Device` and `Stream` API. * Merge match exprs in beep.rs example * Add Input variant along with UnknownTypeInputBuffer and InputBuffer UnknownTypeBuffer and Buffer have been renamed to UnknownTypeOutputBuffer and OutputBuffer respectively. No backends have yet been updated for this name change or the addition of the InputBuffer. * Update null backend for introduction of InputBuffer * Update emscripten backend for introduction of InputBuffer * Make InputBuffer inner field an option to call finish in drop * Update alsa backend for introduction of InputBuffer * Update wasapi backend for introduction of InputBuffer * Update coreaudio backend for introduction of InputBuffer * Update enumerate.rs example to provide more detail about devices The enumerate.rs example now also displays: - Supported input stream formats. - Default input stream format. - Default output stream format. This should also be useful for testing the progress of #201. * Add `record_wav.rs` example for demonstrating input streams Records a ~3 second WAV file to `$CARGO_MANIFEST_DIR/recorded.wav` using the default input device and default input format. Uses hound 3.0 to create and write to the WAV file. This should also be useful for testing the input stream implementations for each different cpal backend. * Implement input stream support for coreaudio backend This implements the following for the coreaudio backend: - Device::supported_input_formats - Device::default_input_format - Device::default_output_format - EventLoop::build_input_stream The `enumerate.rs` and `record_wav.rs` examples now work successfully on macos. * Add `SupportedFormat::cmp_default_heuristics` method This adds a comparison function which compares two `SupportedFormat`s in terms of their priority of use as a default stream format. Some backends (such as ALSA) do not provide a default stream format for their audio devices. In these cases, CPAL attempts to decide on a reasonable default format for the user. To do this we use the "greatest" of all supported stream formats when compared with this method. * Implement input stream support for ALSA backend This implements the following for the ALSA backend: - Device::supported_input_formats - Device::default_input_format - Device::default_output_format - EventLoop::build_input_stream Note that ALSA itself does not give default stream formats for its devices. Thus the newly added `SupportedFormat::cmp_default_heuristics` method is used to determine the most suitable, supported stream format to use as the default. The `enumerate.rs` and `record_wav.rs` examples now work successfully on my linux machine. * Implement input stream support for wasapi backend This implements the following for the wasapi backend: - Device::supported_input_formats - Device::default_input_format - Device::default_output_format - EventLoop::build_input_stream Note that wasapi does not enumerate supported input/output stream formats for its devices. Instead, we query the `IsFormatSupported` method for supported formats ourselves. * Fix some warnings in the alsa backend * Update CHANGELOG for introduction of input streams and related items * Update README to show latest features supported by CPAL * Simplify beep example using Device::default_output_format * Remove old commented code from wasapi/stream.rs
2018-02-12 13:10:24 +00:00
- Add `record_wav.rs` example. Records 3 seconds to
`$CARGO_MANIFEST_DIR/recorded.wav` using default input device.
- Update `enumerate.rs` example to display default input/output devices and
formats.
- Add input stream support to coreaudio, alsa and windows backends.
- Introduce `StreamData` type for handling either input or output streams in
`EventLoop::run` callback.
- Add `Device::supported_{input/output}_formats` methods.
- Add `Device::default_{input/output}_format` methods.
- Add `default_{input/output}_device` functions.
- Replace usage of `Voice` with `Stream` throughout the crate.
- Remove `Endpoint` in favour of `Device` for supporting both input and output
streams.
Publish 0.7 (#200)
2018-02-04 12:03:03 +00:00
# Version 0.7.0 (2018-02-04)
Rename `SamplesRate` to `SampleRate` and `ChannelsCount` to `ChannelCount` (#199) * Rename SamplesRate to SampleRate and samples_rate to sample_rate * Rename ChannelsCount to ChannelCount * Update CHANGELOG for SamplesRate and ChannelsCount renaming
2018-02-04 12:02:16 +00:00
- Rename ChannelsCount to ChannelCount.
- Rename SamplesRate to SampleRate.
Remove unused `ChannelPosition` API (update all backends and examples accordingly) (#198) * Remove ChannelPosition API This removes the ChannelPosition API from the lib root and updates the ALSA backend and examples accordingly. The other backends have not yet been updated. Related discussion at #187. * Update windows backend to removal of ChannelPosition API The windows backend now assumes the channel position order is equal to the channel position mask order. E.g. channel 0 will always be front left, channel 1 will always be front right, etc. Compiled and ran both examples successfully. * Update coreaudio backend to removal of ChannelPosition API Compiled and ran both examples successfully. * Update emscriptem backend for removal of ChannelPosition API * Update CHANGELOG for ChannelPosition removal
2018-02-04 09:38:06 +00:00
- Remove unused ChannelPosition API.
[macos] Implement Endpoint and Format Enumeration Based on #195. Also implements proper handling of the given `Endpoint` in the macos implementation of the `build_voice` method. Updates to the latest coreaudio-sys and coreaudio-rs which include the additional necessary frameworks. Also adds a line that prints the name of the default device in the `enumeration.rs` example. Updates the CHANGELOG for this PR. Closes #194. Related to #180. Related external issues: - RustAudio/coreaudio-sys#4 - RustAudio/coreaudio-rs#57
2018-01-26 12:49:47 +00:00
- Implement Endpoint and Format Enumeration for macos.
Update changelog
2018-01-24 10:34:18 +00:00
- Implement format handling for macos `build_voice` method.
Publish v0.6.0 (#190) There does not seem to be any major API breakage, however the emscripten and macos backends have been pretty heavily refactored so I thought it best to bump to 0.6 (rather than 0.5.2) just in case there is any subtle behavioural breakage. Happy to change this to 0.5.2 though if someone can confirm there will be no downstream breakage.
2017-12-11 08:31:22 +00:00
# Version 0.6.0 (2017-12-11)
Improve the emscripten backend (#172) * Use the js! macro from stdweb * Rework the Buffer::finish method * Use references from stdweb * Fix emscripten warnings * Rework the run() method to use stdweb * Adjust timings * Add entry in CHANGELOG
2017-10-22 12:17:25 +00:00
- Changed the emscripten backend to consume less CPU.
Docs and style improvements (#174) * Improve the crate root documentation * Add entry in CHANGELOG * Run rustfmt on the code * More improvements to documentation
2017-10-23 14:41:38 +00:00
- Added improvements to the crate documentation.
Implement `pause` and `play` for ALSA backend (#176) * Implement `pause` and `play` for ALSA backend This commit also ensures that the Voice is initially paused when returned to remain consistent with the rest of the CPAL backends. Related to #175. * Remove ineffective pause from end of build_voice method * ALSA - Change `is_paused` flag from `AtomicBool` to `bool` * Add pause and play ALSA addition to CHANGELOG
2017-11-02 09:30:15 +00:00
- Implement `pause` and `play` for ALSA backend.
[coreaudio] Remove intermediate buffer (#182) * [coreaudio] Remove intermediate buffer Fixes #181 * [coreaudio] Create voice id after setting format
2017-11-03 09:51:02 +00:00
- Reduced the number of allocations in the CoreAudio backend.
Publish v0.6.0 (#190) There does not seem to be any major API breakage, however the emscripten and macos backends have been pretty heavily refactored so I thought it best to bump to 0.6 (rather than 0.5.2) just in case there is any subtle behavioural breakage. Happy to change this to 0.5.2 though if someone can confirm there will be no downstream breakage.
2017-12-11 08:31:22 +00:00
- Fixes for macos build (#186, #189).
Improve the emscripten backend (#172) * Use the js! macro from stdweb * Rework the Buffer::finish method * Use references from stdweb * Fix emscripten warnings * Rework the run() method to use stdweb * Adjust timings * Add entry in CHANGELOG
2017-10-22 12:17:25 +00:00
Add samples conversion functions and publish 0.5.1 (#170)
2017-10-21 07:45:02 +00:00
# Version 0.5.1 (2017-10-21)
- Added `Sample::to_i16()`, `Sample::to_u16()` and `Sample::from`.
Publish 0.5.0 (#169)
2017-10-21 07:25:24 +00:00
# Version 0.5.0 (2017-10-21)
RFC: Rework the API [WIP] (#165) * Rework the API to not use futures anymore * Add some comments * Update the MacOS backend * Restore the null implementation * Add an emscripten backend * Remove erroneously added feature * Fix to_f32 formula * [WIP] Alsa backend * Alsa backend compiling * Working ALSA backend * Fix tests * Move WASAPI endpoint to endpoint module * Fix WASAPI warnings * Rework the WASAPI backend * Check overflows for voice ID * Add comments and minor fixes to WASAPI backend * Add a changelog
2017-10-18 18:24:05 +00:00
- Removed the dependency on the `futures` library.
- Removed the `Voice` and `SamplesStream` types.
- Added `EventLoop::build_voice`, `EventLoop::destroy_voice`, `EventLoop::play`,
and `EventLoop::pause` that can be used to create, destroy, play and pause voices.
- Added a `VoiceId` struct that is now used to identify a voice owned by an `EventLoop`.
- Changed `EventLoop::run()` to take a callback that is called whenever a voice requires sound data.
Add SupportedFormat (#168)
2017-10-20 19:18:40 +00:00
- Changed `supported_formats()` to produce a list of `SupportedFormat` instead of `Format`. A
`SupportedFormat` must then be turned into a `Format` in order to build a voice.