What You'll Learn

Oscillators are the basic building blocks of video synthesis in Lumen. In this tutorial you’ll learn:

  • What an oscillator is and why Lumen has three of them
  • Which frequencies can be used to create which types of visual patterns
  • How the sync and frequency controls interact with each other
  • How to use the waveshaper and colorizer to fine-tune your patterns

If you’re having trouble finding your way around Lumen’s interface, please check out the Quick Start guide before continuing here.

What is an Oscillator?

Fundamentally, oscillators create a signal that goes up and down at a regular intervals. If you looked at the value of this signal over time, you’d see a wave:

Animation of a signal producing a wave

There are a few common types of waves that you might see oscillators create:

Sine, Saw, Triangle, and Square Waves

By the end of this guide, you’ll be able to create video patterns using Sine, Saw, and Triangle Waves! But first, let’s discuss the basics of video synthesis.

Video from Oscillators

It turns out that when you take a regular pattern of electrical signals generated by an oscillator and feed it into an old CRT TV (with a bit of technical fiddling that you won’t have to worry about in Lumen), you can make moving shapes and patterns appear. This is all because of the way the TV’s electron beam moves across the screen during a frame:

Animation of a signal producing a wave

The notion of treating an analog video electrical signal as something that can be shaped and played with is what video synthesis is all about. Every video synth, from Dan Sandin’s original Image Processor (built way back in 1969!), to modern hardware synthesizers, to Lumen - all of them use this methodology. Don’t worry, though, you don’t have to fully understand the technical details to make some cool art with video synths.

Signal Flow in Lumen

So you’ve got in front of you this video instrument, one that shares the same philosophy as the tools used by the great video artists of the 70s and 80s - let’s make something cool with it, shall we?

First, switch over to the Knobs Panel to check out Lumen’s three identical Oscillators:

Oscillator and Panel Switcher Screenshot

Lumen is what you’d call a Semi-Modular Synthesizer. This means that:

  1. It is built up from smaller parts called Submodules, such as Oscillators and Effects.
  2. Each of these submodules are pre-wired to each other in a particular order to generate and process video signals.
  3. We can change the order that these submodules process the signal in.

The default signal flow can be rerouted from the Patch Panel - we’ll get to this in a later guide. For now, we’ll only be talking about what happens when you haven’t done anything on the Patch Panel yet - we call this scenario the “Default Patch.”

Let’s reset Lumen to the Default Patch now by pressing the Command+N keyboard shortcut, or selecting File -> New from the Application menu.

Here’s a very simplified view of how the submodules inside Lumen are hooked up to each other in the Default Patch:

Oscillator and Mixer Architecture

As you can see, each Oscillator is mixed with the others in the Mixer, then sent through the Effects to the Output.

Making Patterns with Frequencies

Only Showing One Oscillator

To make it easier to see how the Oscillators work, let’s turn down the mix levels such that only the output of the first Oscillator (“Oscillator A”) is visible:

  1. If you haven’t reset to the default patch yet, do that now (Command+N or File -> New)
  2. Find the 2nd and 3rd oscillators from the left (“Oscillator B” and “Oscilllator C”) and turn down the Mix Level on each of them:

Turn Down Oscillator B and C Screenshot

Lumen has three oscillators, each corresponding to a default color of red, green, and blue. Because we turned down the levels on the green and blue oscillators, you should now only be seeing the output from Oscillator A, which has its colorizer set to 100% red by default:

Frequency Knob Screenshot

Now that we’re only showing Oscillator A, let’s start playing with it.

Setting Oscillator Frequency

The number of times per second that an oscillator’s pattern repeats is called its frequency.

Frequencies are measured in Hertz (abbreviated hz), So if an oscillator has a frequency of 1hz, that means its signal will repeat exactly once per second. 50hz means it will repeat 50 times a second.

Frequency Knob Screenshot

The big knob labeled Frequency at the top is used to adjust the frequncy of each Oscillator. These oscillators can go from once every 8 seconds to 1.92 billion times a second!

Pro Tip: The Frequency knob is actually two knobs on top of each other. The outer knob is a “Coarse” control that will let you quickly scan through the entire frequency range, and the inside knob is “Fine” control that can be turned all the way around more than once.

If you were to drag through the entire frequency range, up and down again, you’d see something like this:

Frequency Sweep Animation

Whoa. Let’s break that down - feel free to follow along in Lumen.

Frequency Ranges

Because of the relationship between the oscillator’s signal and your computers’ screen refresh rate (60hz), you can reliably spot certain types of patterns when you use oscillators at certain frequency ranges:

0.125hz - Once you get below about 10hz, all you’ll see is flashing colors:

Frequency Sweep Animation

59.88hz - Above 10hz, we’ll see scrolling lines. If you want to make one that is slow and about the same height as the screen, get near 60hz. In fact, any time you’d like your lines to move slowly or be even divisions of the screen height, set your oscillator’s frequency to a multiple of 60hz (like 120hz or 180hz).

One Line Per Frame Pattern

480.8hz - As you increase the frequency, the number of lines increases:

More Lines Pattern

28.74khz - Above 6khz, the lines start getting really tiny and then you start seeing diagonal lines!

Diagonal Line Patterns

880khz - In the very high frequency range, you can see crazy noise-like patterns:

Patterns at high frequencies

Wow, that’s already a lot of power and that’s only one knob!

Everything we’ve done so far has involved moving lines - surely we can make static images too, right? Let’s explore how to tame these wild oscillations with Sync.

Slowing Things Down With Sync

The sync knob is one of the controls you’ll use the most in Lumen. It allows you to change the speed and direction of the scrolling lines in the patterns above. There are three Sync settings available from this knob at the following positions:


  • Unsynced (fully counterclockwise): This is what we’ve used so far. The oscillator runs free, creating moving lines.
  • Horizontal Sync (halfway turned): This resets the phase of the oscillator every frame, creating a still lines.
  • Vertical Sync (fully clockwise): This resets the phase of the oscillator every horizontal line, which creates still vertical lines!

Pro Tip When turning the Sync knob, you might notice a “notch” in the middle. If you’d rather not have the knob get stuck at this notch as you turn it, you can hold down the Control key while twisting the knob to avoid it.

Science Time The patterns created by video oscillators move over time because the oscillator’s frequency does not exactly match the refresh rate of the screen. Because of this, the phase of the video signal is different at the end of each frame, making the lines begin in different places each frame - which makes the lines look like they’re “moving.” If we were to keep the oscillator’s phase from changing by resetting it every frame, the image would hold still - which is exactly what Horizontal Sync does.

Sync Extras

The three Sync options we mention above, offered traditionally on hardware video oscillators, are all you need to create intricate video patterns. With Lumen, though, we saw an opportunity to push things a little further by making the selection continuous instead of discrete. If you twist the knob all the way from left to right, you’ll see that:

  • Between Unsynced and Horizontal Sync, the motion of the lines slows down. We do this by modifying the oscillator’s frequency to be closer to the nearest multiple of the frame rate (60hz). The closer the knob gets to the Horizontal Sync setting, the closer the frequency gets to a multiple, which makes lines move more slowly.
  • Between Horizontal and Vertical Sync, the lines are rotated. This is a little cheat on our part to make life easier for you - this would not happen in a hardware synth. Handy, though!

Tech Note In hardware video oscillators, to get the same width of lines while vertically synced as you’d see when horizontally synced, you’d have to multiply the oscillator’s frequency by a special value related to the frame rate and screen aspect ratio. Don’t worry, though, we do this for you automatically! All you have to do is turn the Sync knob to the right to get vertical lines.

Wave Shaper and Colorizer

Wave Shaper

We mentioned above a handful of waves that you might find oscillators generating:

Sine, Saw, Triangle, and Square Waves

Lumen’s Oscillators can generate all of these types of waves – you can change which wave type an oscillator generates just by turning the Wave Shape Knob:

Wave Shape Knob Screenshot

You’ll be delighted to see that the shape transitions smoothly from Saw to Triangle to Sine, each with different effects on video patterns. If you’re itching to see how to make Square Waves too, check out the Modulation guide.



Finally, if you’d like to adjust the color of the image an oscillator outputs, click and drag on that oscillator’s Colorizer:

Colorizer Control Screenshot

You can adjust the Hue and Saturation of a color here, and use the Mix Level Knob right next to it to adjust how bright the oscillator’s output appears in the mix.

Pro Tip Just like most interface elements in Lumen, you can double-click the Colorizer to reset it to its default value.

Well Done

This concludes the Oscillator guide - we hope you enjoyed it! To unlock the rest of the power of Lumen’s Oscillators, dive into the Modulation guide next.

What To Read Next