@audiofab-io/fv1-core 0.2.3 → 0.4.0

package/blocks/control/ramp_lfo.atl

@@ -0,0 +1,122 @@
+---
+{
+  "type": "control.ramp_lfo",
+  "name": "Ramp LFO",
+  "category": "Control",
+  "description": "Ramp LFO generator with adjustable rate, amplitude, slope, and dual outputs (Ramp / Triangle).",
+  "color": "#f2b824",
+  "labelTemplate": "${param.lfoSel == 0 ? 'RMP0' : 'RMP1'}",
+  "inputs": [
+    {
+      "id": "speed",
+      "name": "Speed",
+      "type": "control"
+    },
+    {
+      "id": "width",
+      "name": "Level (Width)",
+      "type": "control"
+    }
+  ],
+  "outputs": [
+    {
+      "id": "ramp",
+      "name": "Ramp Out",
+      "type": "control"
+    },
+    {
+      "id": "triangle",
+      "name": "Triangle Out",
+      "type": "control"
+    }
+  ],
+  "parameters": [
+    {
+      "id": "lfoSel",
+      "name": "LFO Selection",
+      "type": "select",
+      "default": 0,
+      "options": [
+        { "value": 0, "label": "RMP0" },
+        { "value": 1, "label": "RMP1" }
+      ],
+      "description": "Which LFO oscillator to use (0 or 1)."
+    },
+    {
+      "id": "speed",
+      "name": "Speed",
+      "type": "number",
+      "default": 6.25,
+      "min": -32,
+      "max": 64,
+      "step": 0.01,
+      "description": "Base LFO rate (used if Speed control is not connected)."
+    },
+    {
+      "id": "amplitude",
+      "name": "Base Amplitude",
+      "type": "select",
+      "default": 4096,
+      "options": [
+        { "value": 4096, "label": "Full (4096)" },
+        { "value": 2048, "label": "Half (2048)" },
+        { "value": 1024, "label": "Quarter (1024)" },
+        { "value": 512, "label": "Eighth (512)" }
+      ],
+      "description": "Internal amplitude limit of the WLDR instruction."
+    }
+  ]
+}
+---
+@if ${param.lfoSel} == 0
+@equals lfoNum RMP0
+@equals lfoRateReg RMP0_RATE
+@else
+@equals lfoNum RMP1
+@equals lfoRateReg RMP1_RATE
+@endif
+
+; Ramp LFO generator
+@section init
+; WLDR accepts discrete amplitudes: 512, 1024, 2048, 4096.
+; Negative frequencies slope Upwards natively. Positive frequencies slope Downwards.
+wldr ${lfoNum}, ${param.speed} * 512, ${param.amplitude}
+
+@section main
+
+; Speed modulation (-1.0 to 1.0 covers -32768 to 32767 natively)
+@if pinConnected(speed)
+  rdax ${input.speed}, 1.0
+  wrax ${lfoRateReg}, 0.0
+@endif
+
+; Ramp output
+@if pinConnected(ramp)
+  cho rdal, ${lfoNum}
+
+  ; Apply width CV scale if connected
+  @if pinConnected(width)
+    mulx ${input.width}
+  @endif
+
+  wrax ${output.ramp}, 0.0
+@endif
+
+; Triangle output
+@if pinConnected(triangle)
+  cho rdal, ${lfoNum}
+  
+  ; SpinCAD derivation: scale by 1.999 to stretch 0..1 to 0..2
+  ; Shift down by exactly half the internal WLDR amplitude ratio
+  ; Then apply ABSA to fold it back into a Triangle!
+  @equals amp_ratio ${param.amplitude} / 4096.0
+  sof 1.999, -0.5 * ${amp_ratio}
+  absa
+
+  ; Apply width CV scale if connected
+  @if pinConnected(width)
+    mulx ${input.width}
+  @endif
+
+  wrax ${output.triangle}, 0.0
+@endif

package/blocks/control/scale_offset.atl

@@ -0,0 +1,84 @@
+---
+{
+  "type": "control.scale_offset",
+  "name": "Scale/Offset",
+  "category": "Control",
+  "description": "Scale and offset a control signal to remap input range to output range.",
+  "color": "#f2b824",
+  "width": 180,
+  "inputs": [
+    {
+      "id": "ctrl_in",
+      "name": "Control",
+      "type": "control",
+      "required": true
+    }
+  ],
+  "outputs": [
+    {
+      "id": "ctrl_out",
+      "name": "Control",
+      "type": "control"
+    }
+  ],
+  "parameters": [
+    {
+      "id": "inLow",
+      "name": "Input Low",
+      "type": "number",
+      "default": 0,
+      "min": 0,
+      "max": 1,
+      "step": 0.01,
+      "description": "Minimum value of input range (0.0-1.0)."
+    },
+    {
+      "id": "inHigh",
+      "name": "Input High",
+      "type": "number",
+      "default": 1,
+      "min": 0,
+      "max": 1,
+      "step": 0.01,
+      "description": "Maximum value of input range (0.0-1.0)."
+    },
+    {
+      "id": "outLow",
+      "name": "Output Low",
+      "type": "number",
+      "default": 0,
+      "min": -2,
+      "max": 1,
+      "step": 0.01,
+      "description": "Minimum value of output range (-2.0 to 1.0)."
+    },
+    {
+      "id": "outHigh",
+      "name": "Output High",
+      "type": "number",
+      "default": 0.75,
+      "min": -2,
+      "max": 1,
+      "step": 0.01,
+      "description": "Maximum value of output range (-2.0 to 1.0)."
+    }
+  ]
+}
+---
+; Scale/Offset
+@section main
+
+@if pinConnected(ctrl_in)
+@minusDouble outRange outHigh outLow
+@minusDouble inRange inHigh inLow
+@divideDouble scale outRange inRange
+@multiplyDouble inLowScale inLow scale
+@minusDouble offset outLow inLowScale
+
+@assert inRange > 0, "Scale/Offset: Input range is invalid."
+@assert outRange > 0, "Scale/Offset: Output range is invalid."
+
+rdax ${input.ctrl_in}, 1.0
+sof ${scale}, ${offset}
+wrax ${output.ctrl_out}, 0.0
+@endif

package/blocks/control/sincos_lfo.atl

@@ -0,0 +1,126 @@
+---
+{
+  "type": "control.sincos_lfo",
+  "name": "Sin/Cos LFO",
+  "category": "Control",
+  "description": "Sine and cosine LFO generator with adjustable rate and width.",
+  "color": "#f2b824",
+  "labelTemplate": "${param.lfoSel == 0 ? 'LFO0' : 'LFO1'}",
+  "inputs": [
+    {
+      "id": "speed",
+      "name": "Speed",
+      "type": "control"
+    },
+    {
+      "id": "width",
+      "name": "Width",
+      "type": "control"
+    }
+  ],
+  "outputs": [
+    {
+      "id": "sine",
+      "name": "Sine",
+      "type": "control"
+    },
+    {
+      "id": "cosine",
+      "name": "Cosine",
+      "type": "control"
+    }
+  ],
+  "parameters": [
+    {
+      "id": "lfoSel",
+      "name": "LFO Selection",
+      "type": "select",
+      "default": 0,
+      "options": [
+        { "value": 0, "label": "LFO0" },
+        { "value": 1, "label": "LFO1" }
+      ],
+      "description": "Which LFO oscillator to use (0 or 1)."
+    },
+    {
+      "id": "speed",
+      "name": "Speed (Hz)",
+      "type": "number",
+      "default": 0.5,
+      "min": 0,
+      "max": 20,
+      "step": 0.01,
+      "conversion": "HZ_TO_LFO_RATE",
+      "description": "Base LFO rate"
+    },
+    {
+      "id": "width",
+      "name": "Width (1.0 equals full swing)",
+      "type": "number",
+      "default": 0.25,
+      "min": 0.0,
+      "max": 1.0,
+      "step": 0.01,
+      "description": "Base LFO width"
+    },
+    {
+      "id": "outputRange",
+      "name": "Output Range",
+      "type": "select",
+      "default": "bipolar",
+      "options": [
+        { "value": "bipolar", "label": "-1.0 to 1.0" },
+        { "value": "unipolar", "label": "0.0 to 1.0" }
+      ],
+      "description": "Output signal range."
+    }
+  ]
+}
+---
+@if ${param.lfoSel} == 0
+@equals lfoNum SIN0
+@equals lfoRateReg SIN0_RATE
+@equals lfoRangeReg SIN0_RANGE
+@equals lfoCos COS0
+@else
+@equals lfoNum SIN1
+@equals lfoRateReg SIN1_RATE
+@equals lfoRangeReg SIN1_RANGE
+@equals lfoCos COS1
+@endif
+
+; Sin/Cos LFO generator
+@section init
+wlds ${lfoNum}, ${param.speed}, ${param.width} * 32767
+
+@section main
+
+; Speed modulation (0 to 20 Hz -> 0 to 160 int)
+@if pinConnected(speed)
+rdax ${input.speed}, 160.0 / 512.0
+wrax ${lfoRateReg}, 0.0
+@endif
+
+; Width modulation (0 to 1.0 fullswing)
+@if pinConnected(width)
+rdax ${input.width}, 1.0
+wrax ${lfoRangeReg}, 0.0
+@endif
+
+; Sine output
+@if pinConnected(sine)
+cho rdal, ${lfoNum}
+@if param.outputRange == 'unipolar'
+sof 0.5, 0.5
+@endif
+wrax ${output.sine}, 0.0
+@endif
+
+; Cosine output
+@if pinConnected(cosine)
+cho rdal, ${lfoCos}
+@if param.outputRange == 'unipolar'
+sof 0.5, 0.5
+@endif
+wrax ${output.cosine}, 0.0
+@endif

package/blocks/control/smoother.atl

@@ -0,0 +1,48 @@
+---
+{
+  "type": "control.smoother",
+  "category": "Control",
+  "name": "Smoother",
+  "description": "Applies a simple low pass filter to smooth the control signal",
+  "inputs": [
+    {
+      "id": "input",
+      "name": "CV In",
+      "type": "control"
+    }
+  ],
+  "outputs": [
+    {
+      "id": "output",
+      "name": "CV Out",
+      "type": "control"
+    }
+  ],
+  "parameters": [
+    {
+      "id": "freq",
+      "name": "Frequency",
+      "type": "number",
+      "default": 1.0,
+      "min": 0.5,
+      "max": 15.0,
+      "step": 0.01,
+      "conversion": "LOGFREQ",
+      "labelTemplate": "${freq} Hz",
+      "description": "Smoother cutoff frequency in Hz. Lower values = slower/smoother response."
+    }
+  ],
+  "color": "#f2f224",
+  "registers": []
+}
+---
+@section header
+@comment "Generated from spincad source file control_smoother.spincad"
+equ filt ${freq}
+
+@section main
+@if pinConnected(input)
+rdax ${input.input}, 1.0
+rdfx ${output.output}, filt
+wrax ${output.output}, 0.0
+@endif

package/blocks/control/tremolizer.atl

@@ -0,0 +1,55 @@
+---
+{
+  "type": "control.tremolizer",
+  "category": "Control",
+  "name": "Tremolizer",
+  "description": "Adjusts the LFO width based on a control signal",
+  "inputs": [
+    {
+      "id": "input",
+      "name": "LFO Input",
+      "type": "control"
+    },
+    {
+      "id": "width",
+      "name": "LFO Width",
+      "type": "control"
+    }
+  ],
+  "outputs": [
+    {
+      "id": "output",
+      "name": "Control Output",
+      "type": "control"
+    }
+  ],
+  "parameters": [
+    {
+      "id": "depth",
+      "name": "Depth",
+      "type": "number",
+      "min": 0.0,
+      "max": 1.0,
+      "default": 0.5,
+      "step": 0.01
+    }
+  ],
+  "color": "#f2f224"
+}
+---
+@section header
+@comment "Generated from spincad source file tremolizer.spincad"
+
+@section main
+// This control block takes a signal (usually an LFO) that goes from 0.0 to 1.0 and 
+// allows you to adjust the ${input.width} via a control ${input.input}.
+// There is also a control panel setting for maximum ${depth}
+// variable - Name - low - high - multiplier - precision - option 
+@if pinConnected(input)
+rdax ${input.input}, ${depth}
+@if pinConnected(width)
+mulx ${input.width}
+@endif
+sof -0.999, 0.999
+wrax ${output.output}, 0.0
+@endif

package/blocks/effects/delay/micro_stutter.atl

@@ -0,0 +1,77 @@
+---
+{
+  "type": "fx.micro_stutter",
+  "name": "Micro-Stutter",
+  "category": "Effects",
+  "subcategory": "Lo-Fi",
+  "description": "Glitchy frozen grain effect. When triggered, stops incoming audio and continuously loops the last active grain buffer.",
+  "color": "#6060c4",
+  "width": 180,
+  "inputs": [
+    {
+      "id": "in",
+      "name": "Input",
+      "type": "audio",
+      "required": true
+    },
+    {
+      "id": "freeze_cv",
+      "name": "Freeze Trigger",
+      "type": "control",
+      "required": false,
+      "description": "CV input. When value > 0.5, the buffer freezes."
+    }
+  ],
+  "outputs": [
+    {
+      "id": "out",
+      "name": "Output",
+      "type": "audio"
+    }
+  ],
+  "parameters": [
+    {
+      "id": "grain_size",
+      "name": "Grain Size (ms)",
+      "type": "number",
+      "default": 100,
+      "min": 10,
+      "max": 500,
+      "step": 1,
+      "conversion": "MS_TO_SAMPLES"
+    },
+    {
+      "id": "level",
+      "name": "Wet Level",
+      "type": "number",
+      "default": 1.0,
+      "min": 0.0,
+      "max": 1.5,
+      "step": 0.05
+    }
+  ],
+  "memories": [
+    {
+      "id": "grain",
+      "size": 16384
+    }
+  ]
+}
+---
+@section main
+  ; Check Freeze CV status
+  @if pinConnected(freeze_cv)
+    rdax ${input.freeze_cv}, 1.0
+    sof 1.0, -0.5                   ; Offset by 0.5
+    skp gez, play_grain             ; If CV > 0.5, skip the write instruction and just recycle the buffer!
+  @endif
+
+  ; Write to buffer (Only executes if NOT frozen)
+  rdax ${input.in}, 1.0
+  wra ${mem.grain}, 0.0
+  
+play_grain:
+  ; Read from buffer at Grain Size offset
+  @equals offset ${mem.grain} + ${param.grain_size}
+  rda ${offset}, ${param.level}
+  wrax ${output.out}, 0.0