From 62c5d69c1be0d667bb89d8e23901a8d0cc24110b Mon Sep 17 00:00:00 2001
From: hemmer <915048+hemmer@users.noreply.github.com>
Date: Fri, 15 Nov 2024 13:18:06 +0000
Subject: [PATCH] Add Oneiroi docs
Tweak EvenVCO so oscillators have same phase relationship as before
---
docs/Oneiroi.md | 16 ++++++++++++++++
docs/img/Oneiroi.png | Bin 0 -> 304742 bytes
src/EvenVCO.cpp | 4 ++--
3 files changed, 18 insertions(+), 2 deletions(-)
create mode 100644 docs/Oneiroi.md
create mode 100644 docs/img/Oneiroi.png
diff --git a/docs/Oneiroi.md b/docs/Oneiroi.md
new file mode 100644
index 0000000..999ef51
--- /dev/null
+++ b/docs/Oneiroi.md
@@ -0,0 +1,16 @@
+# Befaco Oneiroi
+
+Based on [Befaco Oneiroi](http://www.befaco.org/oneiroi) Eurorack module. For the official manual, see [here](https://befaco.org/docs/Oneiroi/Oneiroi_User_Manual.pdf).
+
+
+## Differences with hardware
+
+* Randomisation can optionally be applied to every parameter using the built in VCV randomisation
+* Input gain switch (available on hardware) has been removed as this makes no sense in VCV
+* Undo/redo is natively handled by VCV Rack
+* .wav files can be loaded from the context menu (naive loading no sample rate conversion!)
+* Additional LED indicators have been added for filter type, filter position, modulation type and oscillator octave
+* Distinct virtual knobs are used for each parameter so parameter catch-up (used on hardware) is not needed.
+* As yet, slew of parameter values on randomize is not supported
+
+
diff --git a/docs/img/Oneiroi.png b/docs/img/Oneiroi.png
new file mode 100644
index 0000000000000000000000000000000000000000..204cb9c4cccefc4c403f22fa8011cd1a492346a9
GIT binary patch
literal 304742
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