Publish VCC Plus OSS source distribution for 3.6.2 build 60

This commit is contained in:
Brian Holman committed 2026-11-13 00:14:03 -07:00
commit c652a5276d
1192 files changed
+272368

No files matched your search

+52
View File
@@ -0,0 +1,52 @@
// SPDX-License-Identifier: GPL-3.0-or-later
#ifndef VCC_ORCH90_H
#define VCC_ORCH90_H
// One frame, in playback order. Each DAC accepts a level from 0 through 255.
struct orch90_frame {
unsigned char left;
unsigned char right;
};
#define ORCH90_CLOCK_NORMAL 0
#define ORCH90_CLOCK_FAST 1
// Set both DAC levels. The hardware holds them until another write.
void orch90_write(unsigned char left, unsigned char right);
// Foreground playback at approximately 4,000 stereo frames/second on a CoCo 3.
// Set clock to the CURRENT guest CPU speed. This call leaves that speed,
// interrupt masks and timers alone. Interrupt handlers may delay playback.
// frames must be CPU-readable and remain mapped for the entire call.
// The last frame remains latched. A valid empty block succeeds without writes.
// Returns 1 on success, 0 for a bad clock, missing data or an address wrap.
// Success confirms the data was sent; this write-only hardware has no ID.
unsigned char orch90_play(const struct orch90_frame *frames, unsigned int count,
unsigned char clock);
// Start asynchronous playback on a CoCo 3 BASIC-based setup. Each stereo
// frame lasts four serviced scanlines (about 3,930 frames/s at NTSC timing).
// loop: 0 plays once, 1 repeats. count must be nonzero. Keep the whole frame
// array readable, mapped and unchanged until playback ends. Keep the program,
// its stack and its interrupt handler resident. Call from the foreground.
//
// clock must describe the current CPU clock. The player uses fast speed for
// the duration and restores that setting when done. It borrows the stock BASIC
// IRQ trampoline and PIA horizontal IRQ. IRQ and BASIC's vertical IRQ must
// be enabled and HSYNC free. Sampling begins on the second vertical interrupt.
// Keep these resources exclusive, including the DACs and clock, and allow IRQs
// to run. Long interrupt masks or PIA reads can delay audio. BASIC's vertical
// interrupt still runs. The GIME timer and FIRQ vector are untouched.
// Returns 1 when started, 0 on refusal (including another active playback).
unsigned char orch90_start(const struct orch90_frame *frames, unsigned int count,
unsigned char loop, unsigned char clock);
// 1 while playing, 0 when idle. A one-shot releases its resources after the
// final sample interval. The two write-only DACs then rest at midpoint 128.
unsigned char orch90_active(void);
// Stop immediately and release the IRQ and clock. Safe when already idle.
// Always stop before returning to BASIC, unloading or remapping active data.
void orch90_stop(void);
#endif