Leviathan for VCV Rack 2 · Open Source

Iris

A 12 HP polyphonic oscillator that turns image rows and fractal fields into smoothly scanned waveforms.

12 HPUp to 16 voicesImage-to-wavetableOUT + quadrature Q
Iris front panel

Images into waveforms

Images into waveforms

Iris reads a visual source as a bank of single-cycle waveforms. Across each horizontal row, pixel intensity becomes waveform amplitude; moving vertically through the source selects another waveform. FREQ sets how fast the selected waveform repeats, while SCAN moves between rows. Scanning changes timbre without requiring the pitch to change.

Load an image directly or use Nautiloid to generate a fractal source. Iris supplies the oscillator, pitch tracking, FM, sync, and outputs in both cases. Nautiloid supplies an explorable source field.

The source is resampled into a 1024 × 256 RGB field. The normal table has 256 rows of 1024 samples each; trimming can reduce the row count. The oscillator interpolates through the table. This is image-derived synthesis: it does not play an image as a recording.

First patch

First patch

Start with an image

  1. Add Iris and route OUT through a VCA or mixer to your audio output. Start with a low level.
  2. Right-click Iris and choose Load image..., or use its source button and select Image file.... You can also drop an image file onto the module. The file picker lists PNG, JPG/JPEG, BMP, and TGA.
  3. Set FREQ to a comfortable audio pitch and leave FINE centered. Turn SCAN slowly to explore the source.
  4. Patch a slow LFO or envelope to SCAN and turn up the scan attenuverter. It starts at zero, so a cable alone will not move the scan.
  5. Try COLOR to compare the combined image with the individual red, green, and blue channels.

A source with strong horizontal variation produces a more varied cycle. Rows with nearly constant intensity can produce a flat or weak result. Try another scan position or source if the output is uninteresting.

Use the connected pair

  1. Add Iris and connect OUT to a VCA or mixer, then to your audio output. Start with a low listening level.
  2. Click Iris’s source button below the displays and select Nautiloid. If needed, this creates Nautiloid directly to Iris’s left and makes room for it.
  3. Keep the modules touching in the same row, with Nautiloid on the left. No source cable is required.
  4. On Nautiloid, choose a fractal with the menu button below its display. Drag the display to pan and use the mouse wheel to zoom.
  5. On Iris, turn SCAN to hear different rows of that source. Add pitch CV to V/OCT and a slow modulation source to SCAN, then raise its attenuverter from zero.

Continue with Nautiloid navigation →

Panel breakdown

Controls and displays

Click a numbered marker to jump to its description. The separate connection view below identifies the jacks.

Iris front panel; numbered references are described in the matching legend. 1: Source field, waveform, and frequency11: Source field, waveform, and frequency12: Nautiloid link indicator23: FREQ34: FINE45: OCT56: SCAN position67: SCAN attenuverter78: LIN FM amount89: SOFT910: LFO1011: COLOR1112: Smoothing menu1213: Source menu1314: Display view14
1

Source field, waveform, and frequency

Two displays and the readout below

The upper display shows the field and scan positions; the lower display shows the selected waveform. The frequency readout follows channel one’s base pitch before linear FM.

2

Nautiloid link indicator

Top-left edge

Amber means Nautiloid is attached but its source is pending or not selected; green means Iris has accepted a Nautiloid source.

3

FREQ

Large upper-left knob

Main oscillator frequency. In Audio mode the continuous knob range is 10 Hz–10 kHz; in LFO mode it is 0.01–100 Hz. Pitch CV and FM can extend the resulting frequency beyond the knob range, subject to internal limits.

4

FINE

Small knob beside FREQ

Fine tuning from −100 to +100 cents.

5

OCT

Gold button below V/OCT

Toggles octave-stepped coarse tuning. The coarse pitch snaps to whole octaves relative to C4; FINE and V/OCT still apply.

6

SCAN position

Large right-hand knob

Sets the base scan position from 0–100%. The CV contribution is added and the result is clamped to that range.

7

SCAN attenuverter

Small knob left of SCAN

Bipolar depth for the SCAN input, −100% to +100%; default zero. Negative settings reverse the CV contribution.

8

LIN FM amount

Small knob beside LIN FM input

Depth of the AC-coupled linear-FM input. Higher amounts also introduce drive into the FM control response.

9

SOFT

Gold button beside SYNC

Toggles hard and soft sync. Hard sync resets phase to zero. Soft sync reflects the current phase around the cycle boundary.

10

LFO

Gold button beside the outputs

Switches the coarse frequency range between Audio and LFO.

11

COLOR

Gold button and four channel indicators

Cycles All/luma → Red → Green → Blue. This changes the channel used to generate the table and therefore changes the sound.

12

Smoothing menu

Wave icon below the waveform display

Opens the Smoothing menu, including normalization, row order, trimming, DC removal, and inversion.

13

Source menu

Source icon beside the wave icon

Selects Image file... or Nautiloid. Choosing Nautiloid creates the left-side companion if it is not already attached.

14

Display view

Eye icon below the displays

Toggles the upper display between the converted waveform field and the selected source color-channel view. This changes the view without changing the conversion settings.

At low frequencies a moving tracer helps show phase. The eye button changes the upper display view; COLOR changes the channel used for sound generation.

CV, outputs, and polyphony

CV, outputs, and polyphony

Purple-ringed jacks are inputs; cyan-ringed jacks are outputs. These numbers continue from the controls view.

Iris front panel; numbered references are described in the matching legend. 15: V/OCT1516: LIN FM1617: SCAN1718: SYNC1819: OUT1920: Q20
15

V/OCT

Upper row, between FINE and SOFT

1 V/octave pitch control, added to coarse and fine tuning. Supports polyphonic pitch.

16

LIN FM

Lower-left jack

AC-coupled frequency modulation, scaled by LIN FM amount. A steady DC offset is rejected; use V/OCT for static pitch changes.

17

SCAN

Middle input beside the scan attenuverter

Scan offset: 10 V spans the full table at +100% depth. Effective scan = knob + (CV ÷ 10 V) × attenuverter, clamped to 0–100%. For example, a ±5 V LFO at full depth sweeps across the full table when the knob is centered at 50%.

18

SYNC

Upper-right input

A rising trigger synchronizes each voice according to SOFT. Supports corresponding polyphonic channels.

19

OUT

Left cyan output

Main wavetable output, scaled by 5 V per unit waveform amplitude. Actual level and DC content depend on the source and conversion settings.

20

Q

Right cyan output

The same table read one quarter-cycle ahead of OUT. It is a 90° phase offset, rather than an inverted copy. Both outputs carry the same voice count.

Iris supports up to 16 voices. The greater channel count at V/OCT or SCAN sets the output voice count, with a minimum of one. LIN FM and SYNC modulate those voices but do not create additional voices by themselves. Where a voice has no matching V/OCT channel, it uses pitch channel one; mono SCAN, LIN FM, and SYNC signals are shared through Rack’s polyphonic input handling.

Polyphonic SCAN can give several voices different timbres at a common pitch. Combine polyphonic pitch and scan to make each note explore a different part of the image.

Smoothing and conversion

Smoothing and conversion

Click the wave icon to open Smoothing. These options rebuild the table from the current source; they do not require the original image file while that source is still available. New tables crossfade into playback over approximately 30 ms.

ControlFunction
Seam smoothingBlends the beginning and end of each row toward a common edge value. Use it to soften the jump where the waveform loops; this also changes the cycle shape.
Wave smoothingSmooths the samples within each waveform cyclically. Increasing it reduces fine detail and can soften a bright, jagged source.
Normalize → BalancedDefault. Uses the image-wide intensity distribution to balance positive and negative waveform ranges while reducing the influence of extreme outliers.
Normalize → GlobalUses one minimum/maximum range across the whole table. Preserves relative level differences between rows.
Normalize → Per rowCenters and scales each non-flat row independently. Can make quiet rows more prominent and reduce level variation while scanning.
Normalize → OffLeaves normalization off. The image intensity mapping and other selected conversion operations still apply.
Row orderTop to bottom (default) or Bottom to top. Reverses the order of rows in the table. The source-channel view remains in the original source orientation.
Trim flat rowsOff (default), Gentle, Medium, or Aggressive. Removes rows whose amplitude variation is below the selected threshold, retaining at least two endpoint rows if too few remain. This changes how scan positions map to the source.
Per-row DC removalSubtracts each row’s mean. Useful when a source produces a large static offset. Off by default.
Invert conversionReverses waveform polarity during conversion. Off by default.

Seam smoothing and Wave smoothing default to zero. Normalization and DC removal affect the result differently: centering the table as a whole does not guarantee that every individual row has zero mean.

Sources and patch storage

Sources and patch storage

Image controls in the right-click menu

ControlFunction
Load image...Imports a new image and rebuilds the table. Also available through the source button or file drag and drop.
Reload imageAttempts to reload the original file from its saved path. Disabled when there is no path. If reload fails and a valid current source is available, that source is preserved for rebuilding.
Clear imageReturns to the built-in Sine / Triangle / Saw / Square table and clears the image source. SCAN morphs through those shapes.
Embed image source in patchEnabled by default. Saves the canonical RGB image source with the patch, so image-based tables can be rebuilt and color channels changed without the original external file.

Embedding stores the resampled source rather than the full-resolution original image. With embedding disabled, an image patch depends on the original file path; keep that file accessible when moving the patch. Missing or unusable source data can leave Iris using its built-in default table.

Switch between a file and Nautiloid

Load an image to use it even while Nautiloid is attached. Select Source → Nautiloid to resume the companion feed. If a restored patch deliberately used an image beside Nautiloid, that image-source choice is preserved.

For generated Nautiloid fractals, Iris saves the generator settings needed to reconstruct the source instead of embedding an image file. Save the pair together to retain both the oscillator settings and the explorer’s current position and palette. The Embed image source option concerns image-file storage.

Patch ideas

Patch ideas

Slow spectral travel

Load an image, set SCAN near 50%, and patch a slow ±5 V LFO into SCAN. Start with a small positive depth and increase it gradually.

Pitch stays steady while the selected row moves. Try Global normalization to preserve the source’s level changes.

Fractal voice bank

Attach Nautiloid, choose a detailed boundary, then send polyphonic SCAN to Iris. Add polyphonic V/OCT for a chord.

Each voice can read a different row of the same fractal while retaining independent pitch.

Quadrature modulation

Enable LFO and set a slow frequency. Use OUT and Q to modulate two destinations. Begin with a smooth source and modest destination depths.

The outputs are a quarter-cycle apart. Their shape and offset follow the source, so inspect the waveform before using them as control signals.

Troubleshooting

Troubleshooting

SCAN CV does nothing

Raise the scan attenuverter from zero. Check that the knob plus CV is not pinned at 0% or 100%. Try another source if adjacent rows look alike.

The source makes a flat or weak waveform

Move SCAN, change COLOR, or load an image with more variation across its rows. Consider Per row normalization and Per-row DC removal. A flat image row contains little changing waveform information.

Nautiloid changes its picture but Iris does not follow

Keep Nautiloid immediately to Iris’s left and select Source → Nautiloid on Iris. An explicitly loaded image can remain active beside the companion. Allow source generation and conversion to finish.

Q is not the negative of OUT

Q reads the waveform a quarter-cycle ahead. For arbitrary image-derived cycles, quadrature and polarity inversion produce different shapes.

The image is missing after moving a patch

For image-file sources, enable Embed image source in patch before saving, or keep the linked original at an accessible path. Load the image again if necessary.

A rapid fractal gesture sounds delayed

Source rendering and table conversion are asynchronous. Iris keeps playing while new work completes, then crossfades the table. These changes are not an audio-rate modulation path; use SCAN, FM, and sync for direct oscillator modulation.

Reference

Reference

VCV Rack 2 · 12 HP · up to 16 voices · four inputs · OUT and Q outputs · image or left-side Nautiloid source.

Nautiloid User Manual →

Checked against the local Iris engine, widget, polyphony helpers, image conversion, source persistence, and Nautiloid handoff. Appearance and available behavior can differ between releases.