orklev2-portaudio

What problem does it solve?

This Skill provides focused documentation and actionable answers for developers working with Orkid's PortAudio audio backend so they can understand callback threading, data format conversions, device selection, and how the Singularity synth is driven without scanning the entire codebase.

Core Features & Use Cases

• PortAudio callback model: Describes the single-callback flow where PortAudio invokes the audio thread callback, how input is converted from int16 to float, how the Singularity synth is called to compute output, and how buffers are interleaved for output.
• Device selection and resolution: Explains enumerating PortAudio devices, resolving 4-character base36 short IDs to device names, matching channel counts, and opening/starting streams with overrides.
• Platform and performance notes: Documents sample formats (int16 input, float output), typical frames-per-buffer differences between macOS and Linux, and CPU load tracking via the PortAudio API. Use cases include diagnosing callback latency or artifacts, verifying device mapping by short ID, and understanding how audio data flows into and out of the Singularity synth for cross-platform playback.

Quick Start

Explain how Orkid's PortAudio backend converts int16 input to float output, selects devices by short ID, and how the Singularity synth is invoked on the PortAudio callback thread.