DSWaveformImage

Fixes an issue w/ striped rendering always drawing the last stripe as a line instead of a proper bar.

see #85

Re-add ability to position waveform when using the image APIs.

Bring back support for visionOS from 14.1.0.

• remove vision OS support for now again as it was causing troubles with Xcode 14

• add the possibility to handle "loading" state in WaveformView - courtesy of @alfogrillo in #82
• add support for visionOS - courtesy of @tapsandswipes in #81

• Minimum iOS Deployment target is 15.0, macOS is 12.0 to remove internal usage of deprecated APIs
• WaveformAnalyzer and WaveformImageDrawer now return Result<[Float] | DSImage, Error> when used with completionHandler for better error handling
• WaveformAnalyzer is now stateless and requires the URL in .samples(fromAudioAt:count:qos:) instead of its constructor
• SwiftUI's WaveformView has a new constructor that provides optional access to the underlying WaveformShape, which is now used for rendering, see #78

What's Changed

• Add missing @available annotation for macOS in WaveformLiveCanvas view by @TikhonP in https://github.com/dmrschmidt/DSWaveformImage/pull/73

New Contributors

• @TikhonP made their first contribution in https://github.com/dmrschmidt/DSWaveformImage/pull/73

Full Changelog: https://github.com/dmrschmidt/DSWaveformImage/compare/13.0.1...13.0.2

• bug fix for #71

Any mentions of dampening & similar were corrected to damping etc in 11460b8b.

Most notably in Waveform.Configuration.

See https://github.com/dmrschmidt/DSWaveformImage/issues/64.

Includes a fix for #58.

• The rendering pipeline was split out from the analysis. You can now create your own renderes by subclassing WaveformRenderer.
• A new CircularWaveformRenderer has been added.
• position was removed from Waveform.Configuration, see 0447737.
• new Waveform.Style option have been added, see below

Waveforms can be rendered in 2 different ways and 5 different styles each.

By default LinearWaveformRenderer is used, which draws a linear 2D amplitude envelope.

CircularWaveformRenderer is available as an alternative, which can be passed in to the WaveformView or WaveformLiveView respectively. It draws a circular
2D amplitude envelope.

You can implement your own renderer by implementing WaveformRenderer.

The following styles can be applied to either renderer:

• filled: Use solid color for the waveform.
• outlined: Draws the envelope as an outline with the provided thickness.
• gradient: Use gradient based on color for the waveform.
• gradientOutlined: Use gradient based on color for the waveform. Draws the envelope as an outline with the provided thickness.
• striped: Use striped filling based on color for the waveform.

• fixes striped style's 1st stripe only being drawn half (see https://github.com/dmrschmidt/DSWaveformImage/issues/48#issuecomment-1312572313)

Full Changelog: https://github.com/dmrschmidt/DSWaveformImage/compare/11.0.0...11.0.1

Adds support for native macOS

Uses NSImage on macOS now, so the lib (and SwiftUI views) can be used from within plain macOS apps.

To support this better, the library is split up into 2 parts now:

import DSWaveformImage // for core classes to generate `UIImage` / `NSImage` directly
import DSWaveformImageViews // if you want to use the native UIKit / SwiftUI views

Big shoutout to @jverkoey for his PR to add native macOS support!

Full Changelog: https://github.com/dmrschmidt/DSWaveformImage/compare/10.1.0...11.0.0

Adds native SwiftUI views for both static rendering and live rendering.

See WaveformView and WaveformLiveCanvas.

Full Changelog: https://github.com/dmrschmidt/DSWaveformImage/compare/10.0.1...10.1.0

10.0.0 changed the initial draw direction in the live view to always be right to left, even when there are still less samples than are needed to fill the entire view.

While this kind of is a minor change, it is still changing existing behavior, which may break somebody's expectations.