Box Of Synths manual

Box Of Synths manualThe synth

Macros

The MACROS block: what a macro is, asking for new ones, the six cards, switching one off or removing it, and the detail view with its links.

A macro is one big dial that moves several small things at once. Instead of hunting through the filter, the oscillators and the effects, you turn one dial called Bright or Punch and the sound changes the way its name says. The designer writes the macros for each sound and names them. The MACROS block sits between the ENGINE block and the chat.

Macros Click any numbered part of the picture to read what it does.
The MACROS block of Box Of Synths: a title row with the Generate macros key, and six macro cards, each with a spark glyph, a power glyph, a dial, a value and a name.

A macro is one big dial that moves several small things at once. The designer writes the macros for each sound and names them. The ENGINE block above is folded here so the macros stand out.

  1. 1Engine title (folded)Link

    The ENGINE block folded to its title. Click the title to open it again. See Engine: oscillators.

  2. 2Macros titleLink

    Click the title to fold the block. Folded, it lists every macro as its name and value, joined by dots, along the right of the title. Click again to open it.

  3. 3Macros hint and arrowDisplay

    The words SHAPE THE SOUND WITH CONTROLS YOU DECIDE and an arrow. Until the designer has written macros for the sound, the arrow bobs toward Generate macros.

  4. 4Generate macrosKey

    Asks the designer for a new set of macros. The chat opens in Edit with the words Design a new set of macros for this sound: already started and the cursor in the box. Finish the sentence and send it. Nothing is sent until you send it. The new macros replace the old ones.

    Greyed until a sound exists, with the tip Generate a sound first. Otherwise the tip is Ask the designer for a new set of macros for this sound. See The chat.

  5. 5Macro cardArea

    One macro. This card is Bright. A card holds a spark glyph at the top left, a power glyph at the top right, a dial, the value and the name. Each card has its own shade of the accent colour, and its edge lights up under the pointer. Double-click the card to see what it controls. Right-click the card, away from the dial, to remove it. Hover for its tip, which reads the macro's name, a colon, and what it does.

    Hover tip for this card: Bright: Opens the filter: up is brighter and thinner, down is darker and rounder. A macro the designer invented says : a character control the designer invented for this sound.

  6. 6Spark glyphKey

    Click to ask the designer to change this one macro. The chat opens in Edit with Change the <name> macro: started and the box focused, and the card lights while the request waits. Finish the sentence and send it. If the chat was folded, it opens. The spark is bright when the designer made the macro and dim grey when not.

  7. 7Power glyphSwitch

    Switches this macro on or off. An off macro stops moving what it is wired to, its card steps back to the panel colour and its dial dims. Its value is kept. You can undo it.

  8. 8Macro dialDial

    Drag it and everything the macro is wired to moves together. The sound follows as you drag. Every dial gesture on How dials, sliders and keys behave works here: Shift for fine control, double-click to type a value, Alt (Option on a Mac) click to go back to the designer's setting.

    Options

    Each macro has its own range and unit, set by the designer.

  9. 9Macro valueDisplay

    The macro's current reading in its own unit, for example 0.0 oct, 38% or 0%.

  10. 10Macro nameDisplay

    The macro's name, up to 14 characters. There is no way to type a new name. To change a name, or what a macro does, ask the designer with the spark.

  11. 11The other macrosArea

    The rest of the six. A fresh synth starts with the standard macros, and the designer replaces them with ones that suit the sound. Here the others are Res, Sub, Saturation, Noise and Punch. At most six cards show.

The title row

Click the MACROS title to fold the block. Folded, it lists each macro as its name and value, joined by dots. While the block is open, the words SHAPE THE SOUND WITH CONTROLS YOU DECIDE sit beside the key. Until the designer has written macros for the sound, an arrow beside them bobs toward the key.

Generate macros

Click Generate macros to ask the designer for a new set. The chat opens in Edit with Design a new set of macros for this sound: started and the cursor in the box. Finish the sentence, say what the macros should control, and send it. Nothing is sent until you send it. The key is greyed with the tip Generate a sound first until the sound exists. See The chat.

A macro card

Each card holds:

  • a spark glyph at the top left. Click it to ask the designer to change just this macro. The chat opens in Edit with Change the <name> macro: started, and the card lights while the request waits.
  • a power glyph at the top right. Click it to switch the macro off. An off macro stops moving what it is wired to, its card steps back and its dial dims. Its value is kept. Click again to switch it on.
  • a dial. Drag it and everything the macro is wired to moves together. It behaves like every other dial, see How dials, sliders and keys behave.
  • the value, in the macro's own unit, such as 0.0 oct or 38%.
  • the name, up to 14 characters.

Each card has its own shade of the accent colour, and its edge lights under the pointer. There is no way to rename a macro by hand. To change a name or what a macro does, use the spark and ask.

Hover tips

Point at a card and its tip reads the macro's name, a colon and what it does. Examples: Bright: Opens the filter: up is brighter and thinner, down is darker and rounder. and Res: Resonance at the filter's edge: a peak that whistles as it goes up. The other four standard macros read:

  • Sub: A sub oscillator an octave below: weight under the sound.
  • Saturation: Drive into the filter: harder and thicker as it goes up.
  • Noise: White noise mixed in with the oscillators: breath and grit.
  • Drift: Detunes the oscillators against each other, in cents: a slow beating that gets wider as it goes up.

A macro the designer invented for the sound says : a character control the designer invented for this sound.

Remove a macro

Right-click a macro card, on the card and not on its dial, to remove it. Only the card goes. It is one undo step. To get macros back, use Generate macros. A right-click on the dial opens the LFO link menu instead, see Engine: LFOs and modulation.

The limit of six

At most six macro cards show. A fresh synth starts with a standard set, and the designer replaces them with ones that suit the sound. If a sound has fewer than six, the row is topped up from a few standard ones. A macro that only moves the volume envelope is not shown as a card, because the Volume envelope block already holds those controls.

The detail view

Double-click a macro card to see what it controls. The other cards step aside, the card you chose sits at the left, and the detail fills the rest of the row. Press Esc, double-click the macro again, or click outside to close it.

Macro detail Click any numbered part of the picture to read what it does.
The macro detail view: the Bright card at the left and a panel beside it with one row, Cutoff (Filter), with an intensity track, 100 percent, 9000 Hz and a link key.

Double-click a macro card to open its detail. The other cards step aside, the card you chose sits at the left, and the detail fills the rest of the row. It lists every control the macro reaches.

  1. 1The open macroArea

    The card you double-clicked, still live: its dial still works while the detail is open.

  2. 2Macro detailArea

    The detail panel. It closes when you press Esc, double-click the macro again, or click outside it. When the macro reaches nothing it says This macro reaches nothing yet.

  3. 3Macro nameDisplay

    Names the macro whose links you are reading.

  4. 4Column headingDisplay

    Reads LINK - INTENSITY - VALUE, the three things each row shows, plus the percentage in the middle.

  5. 6Intensity trackSlider

    How much of the macro's swing reaches this control. Click or drag to set it: the thumb goes where the pointer is, and the whole drag is one undo step. A mark at the middle is zero. Left of it inverts the link, so turning the macro up closes the control instead. Double-click to go back to 100%.

    Options

    -200% to +200%, in steps of 5%.

    Starts as
    100%
  6. 7Intensity percentageDisplay

    The intensity as a number, for example 100%.

  7. 8Value nowDisplay

    The value the control has right now, with the macro included, for example 9000 Hz. It moves as you turn the macro dial.

Each row of the detail is one link. It reads the control the macro reaches, with its part of the synth in brackets, an intensity track, the intensity as a percentage, and the value the control has right now. The columns are headed LINK - INTENSITY - VALUE. When the macro reaches nothing, the detail says This macro reaches nothing yet.

  • Intensity: click or drag the track to set how much of the macro's swing reaches this control. It runs from -200% to +200% in steps of 5%. A negative value turns the link upside down. Double-click the track to return to 100%. A track only answers while its link is on. One drag is one undo step.
  • Value: shows what the control reads with the macro included. It moves as you turn the macro.
  • Link key: click to unlink the row. The macro's share is folded into the control's own setting, so the sound does not jump, and the key gets a red slash. Click again to relink.
Walkthrough Use a macro and see what it does
  1. 1Turn a macro

    Drag the dial on a macro card. The sound follows as you drag, and the value under the dial changes.

  2. 2Open the detail

    Double-click the card. The other cards step aside and the detail opens beside it.

  3. 3Read the links

    Each row names a control the macro moves. The value at the right shows what the control reads now.

  4. 4Change how much it reaches

    Click or drag the track. Double-click it to return to 100%.

  5. 5Take one link out

    Click the link key. The glyph gets a red slash and the sound does not jump. Click again to relink.

  6. 6Close the detail

    Press Esc, double-click the macro, or click outside the detail.

See also

Macros can also be moved by LFOs, see Engine: LFOs and modulation. A macro's pull on the filter resonance is explained under Base res on Engine: filters.