Skip to content

v4.0.0-alpha.2

Pre-release
Pre-release

Choose a tag to compare

View all tags
@giovannibedetti giovannibedetti released this 11 Nov 21:57
· 2 commits to master since this release
v4.0.0-alpha.2
4245105

CsoundUnity 4.0.0-alpha.2 requires Unity 2022.3 LTS or newer. In Unity: Window → Package Manager → + → Add package from git URL…, then paste:

https://github.com/rorywalsh/CsoundUnity.git#v4.0.0-alpha.2

The 4.0 documentation includes updated screenshots and GIFs.

4.0 documentation · Migration from 3.x · 3.x documentation

What's new since alpha.1

  • Csound 7.0.0. The native libraries and WebGL bundle move from the Csound 7 beta to the 7.0.0 release. The visionOS package includes the iOS build on an experimental basis.
  • Array and spectral channels. Pass numeric arrays (i[], k[]), UTF-8 string arrays (S[]), audio arrays (a[]), and PVS spectral frames between Unity and Csound. Each channel type has a sample and smoke checks.
  • Cabbage 3. Load JSON widget definitions, including widgets with multiple channels. The parser reports unsupported declarations.
  • Timeline sequencing. Automate Master BPM and scale it per clip. Pattern and Step clips in BPM-step mode can share a beat grid. Use Score State to save an entire sequencer Timeline or a single clip as a preset. Playback events cover clips, notes, and steps. Musical Transport is experimental.
  • Procedural Doppler and audio recording. CsoundUnityDoppler sends motion data to the Csound orchestra so it can apply pitch shift and propagation delay. AudioOutputRecorder captures Unity's mixed output to WAV or AIFF, including in player builds, and reports when audio callbacks arrive late. Use those timestamps to investigate clicks you heard during playback that are absent from the recording.

Try these samples

Import the samples from the Samples tab for CsoundUnity in Package Manager.

  • StepAndPatternTimeline_MasterClock demonstrates tempo automation and keeps clips of different lengths in sync.
  • DopplerFlyby lets you hear pitch shift and propagation delay on a passing procedural sound.
  • ApiSmokeTest in Diagnostics exercises the public API and prints a pass/fail report you can include in an issue.

Upgrading from alpha.1

  • Component names changed. Update any scripts that refer to CsoundTimelineController, CsoundTimelineStarter, NativeAudioInputManager, or CsoundUnityNativeInputMonitor. Their new names are CsoundUnityTimelineController, CsoundUnityTimelineStarter, CsoundUnityNativeAudioInput, and CsoundUnityNativeAudioInputMonitor, respectively. The script GUIDs are unchanged, so existing scene and prefab references are preserved.
  • Cabbage level meters. Replace meter in your CSD with vmeter or hmeter to match its orientation.
  • Mono child output. Mono CsoundUnityChild now uses the parent signal level. Check your mix if you compensated for the previous lower level.

Known issues and limitations

  • Editor shutdown. The Unity Editor may crash on quit, with an unresolved address above exit() in the stack trace.
  • iOS and visionOS. iOS builds, with device playback still to be verified. visionOS is experimental and ships the iOS Csound build. Device and simulator testing are pending, and native low-latency input is unavailable.

For audio or platform reports, include your Unity version, platform, sample or steps to reproduce, and any Diagnostics output.

Full changelog for alpha.2 · Report an issue

Assets 2
Loading