User Manual

From Patchblocks
Jump to: navigation, search
The Patchblocks Rainbow Set.

Welcome to Patchblocks, the programmable mini-synth modules!


Concepts[edit]

  • Patchblock: The hardware device that is being programmed.
  • Patchblocks: The name of the software used to program a PatchBlock. This is also referred to as the editor or emulator.
  • Controls: Each Patchblock has two analog (potentiometer/knob) and two digital (button) controls. These are represented in the emulator by the Controls block.
  • Blocks: The smallest building block used to program a Patchblock. A block may take inputs, calculate some arbitrary function, and return outputs which in turn can be routed to serve as an input of another block.
  • Connector: A visual line drawn between two Blocks that represents the transfer of information from one Block's output to another Block's input. Connectors are represented in green (Control Rate) or red (Audio Rate) depending on the status of the Block that is sending the information.
  • Patch: A collection of blocks and connectors that is uploaded onto a Patchblock using the Patchblocks software.
Basic Patch

Blocks Documentation[edit]

There are several official blocks that are shipped with the Patchblocks software. One can also program custom blocks. The PatchBlocks community has a blocks section dedicated to sharing blocks with other users. See the wiki page How to Add Custom Blocks on how to install a block downloaded from there.

Example Blocks

Official Blocks[edit]

The default blocks included in the Patchblocks software are separated into categories found in the Browser tab of the Patchblocks software window. The categories include Effects, Generators, In/Out, Logic, Math, MIDI, Routing, and Sequencing.

Effects
Block Name Description
Bitcrush Bitdepth and samplerate reducer
Delay10 Single 10bit delay
Delay8 Delays input by amount of samples
Delay8F Feedback delay
Delay8FL Feedback delay
Delay_LA Lo-fi feedback delay
Filter Multimode filter
Filter BP Bandpass filter
Filter HP Highpass filter
Filter LP Lowpass filter
Fold Foldback distortion
Fuzz Fuzzy foldback distortion
Lag First order lag filter
Limiter Brickwall limiter
Overdrive Overdrive distortion
Roll Roll granulator
Generators
Block Name Description
ADSR ADSR envelope generator
Impulse Impulse oscillator
Line Line envelope generator
Noise Noise generator
Pulse Pulsewave oscillator
Saw Saw oscillator
Sine Sinewave oscillator
Triangle Triangle oscillator
Walk Random walk noise generator
In / Out
Block Name Description
Audio Input The stereo audio input block
Audio Output The main audio output block
Controls The button and rotary knob controls
LEDs Controls the button LEDs
Post Post value to console
Logic
Block Name Description
AND Logical AND
Comparator Compares two inputs
Equal Checks if two values are equal
Greater Compares two inputs for 'greater than' relationship
Less Compares two inputs for 'less than' relationship
NOT Logical NOT
OR Logical OR
XOR Logical XOR
Math
Block Name Description
Add Adds two values together
Clip Hard clipping
Divide Divides the first value by the second
Floor Rounds a value to the next lowest integer
Map Converts from one range of values linearly into another
MIDI2Cps Converts a MIDI number to its frequency in Hz
Modulo Divide two values and send out the remainder
Multiply Multiplies two values
Number Send a constant value
Subtract Subtracts the second value from the first
MIDI
Block Name Description
MIDI CC In Read CC messages from the MIDI input
MIDI CC Out Send CC messages to the MIDI output
MIDI Clock In Read clock messages from the MIDI input
MIDI Clock Out Send clock and Start / Stop messages
MIDI Note In Read note messages from the MIDI input
MIDI Note Out Send note, velocity, and channel messages
MIDI Through Place this block anywhere in your patch to forward all incoming MIDI messages to the output.
Routing
Block Name Description
Distribute Routes an input to one of the outputs
Fade Fades between two inputs
Mix2 Mixes 2 inputs into one output
Mix4 Mixes 4 inputs into one output
Pan Pans between two outputs
Receive Receives values from one of 16 buses
Select Selects one input and routes it to the output
Send Sends values to one of 16 buses
Split Routes an input to two outputs
Split 4 Routes an input to four outputs
Toggle Toggles between two inputs when triggered
Sequencing
Block Name Description
A2C Converts an audio rate trigger to control rate
Count Counts triggers to max values
CountSeq Counts triggers to max values
Gate Holds open value for duration when triggered, then closed value
Hold Holds a value for amount of seconds when triggered
Metro Metronome
Pattern Cycles through multiple sequences
RanSeq Picks a random value from a list when triggered
SampleHold Traditional sample and hold block
Sequence Cycles through a sequence of values
TrigDiv Divides a stream of triggers

3rd Party Blocks[edit]

Block Name Description
Data Demux Distributes data to four different channels
Data Mux Mux encode four data channels
Knob Expander Expand Knob functions for multiple control uses
Bistable Toggle between high and low values
Storage (quad / flex) Store data for automation, simple values, etc.
Smooth Smooth an incoming signal by an average
Stutter8 8-bit stuttering effect with reverse and forward playback
SQRT Calculates square root of input
LCR Utility router to sum/split mono and stereo signals
Round Utility block to perform floor or ceiling rounding
Catch Variation on the Latch block
Latch Hold value or send them through
Squared Squares the input value
MtoF Converts Midi to Frequency including fractions
ADSRe ADSR block with exponential curves
Distribute Mini Distribute block with only two outputs
Select16 Expanded Select block
Distribute16 Expanded Distribute block
Split16 Expanded Split block
Sawmill Saw wave amplitude follower
Parachute Digital waveshaper and fuzz
Delay-LO Long/Lo-fi delay
AllPass Filter 4-pole allpass filter
Biquad Filter Standard two-pole two-zero filter
Abs Calculates absolute value of input
Split8 Expanded Split block
Peak Calculates the peak value from a block of samples
RMS Calculates the root mean value
Zero Crossing Calculates the zero crossing rate