
DIN Is Noise 
Copyright (c) 2006-2017 Jagannathan Sampath <jag@dinisnoise.org>.

Microtonal-Keyboard

Instrument:

1 : switch to other instruments.

or

choose instrument from Menu > Instrument

Editors:

2 : microtonal-keyboard waveform
3 : drone modulation
4 : voice modulation
5 : gater
6 : delays
7 : octave shift
8 : drone waveform

or choose from Menu > Editors

Drone:

  A drone is a continuous sounding tone.
  Create drones on the microtonal-keyboard.
  Height of the drone is its volume.

  q - add drones. hold and move mouse to spray 

  or

  choose Menu > Drone Tools > Add. click to add a drone, click
  and drag to spray, ESC to stop.

  Click & drag a box to select drones.

  l - select all drones

  i - invert selected drones
      
  e - press once and just move mouse to move selected drones:

    move in x changes pitch of selected drones.
    move in y changes volume of selected drones.
    move in both changes both.

      press CTRL to move only in x
      press SHIFT to move only in y

    press e again or click or ESC to stop.

  Or

  choose Menu > Drone Tools > Move. Move as above.

  Menu > Drone parameters > Rotate to rotate selected drones or

    NUMPAD 1 - rotate anti-clockwise
    NUMPAD 2 - rotate clockwise

  Menu > Drone parameters > Scale to scale selected drones or 

    NUMPAD 4 - scale down
    NUMPAD 5 - scale up


  c - delete selected drones or choose Menu > Drone Tools > Delete 
      Careful! No undo :)

	SHIFT + c - delete selected drones but swansong them by moving under gravity

  SPACE - mute/unmute lead voice (useful when you want to work 
          just on drones)

  or 

  Click on Voice at the bottom of the microtonal-keyboard.

  , - decrease drone master volume
  . - increase drone master volume
  
  For selected drones,

    - - decrease trail length
    = - increase trail length

    9 - reduce handle size
    0 - increase handle size

    j - freeze / thaw moving drones

  Drone launch:

    A drone launcher launches drones at regular intervals into the 
    microtonal keyboard with an initial speed and direction. These 
    drones fall due to gravity to the bottom of the microtonal keyboard 
    to bounce back unless they target another drone to become one of 
    its satellites.

    h - toggle selected drones into drone launchers
    SHIFT + h - select launched drones too. useful for freeze/thaw

		SHIFT + l - select all drone launchers

    n - decrease drones per minute launched
    m - increase drones per minute launched

    [ - decrease speed of launched drones
    ] - increase speed of launched drones
    SHIFT + [ - rotate direction of launch anti-clockwise
    SHIFT + ] - rotate direction of launch clockwise
    CTRL + ] - toggle drawing of velocity vectors

    or set from Menu > Drone Parameters

    You can set the number of times the launched drone bounces back from the
    bottom of the microtonal keyboard with Menu > Drone Tools > Bounces.

    You can also set the amount of speed the bounced drone has on rebound as
    a % of speed going in thru Menu > Drone Tools > Speed %

    You can set the lifetime of the launched drone with Menu > Drone Parameters > Change
    lifetime.  
    
    A launched drone dies at the end of its life or when it has bounced
    enough, whichever is earlier.

  Orbiting drones:

    Select a bunch of drones and Menu > Drone Tools > Orbit
    The last selected drone becomes the planet. The other drones
    become satellites. Or

    F4 - orbit selected drones

    also,

    ; - select the planet
    ' - select the satellites

    o - decrease acceleration of satellites towards planet
    p - increase acceleration of satellites towards planet
    CTRL + p - toggle drawing of acceleration vectors

  Launch drones that become satellites:

    A launcher can supply satellites to a planet ie drones 
    launched from a drone launcher can orbit another drone: 

      Select a bunch of drones. 
      Choose Menu > Set targets.
      First drone becomes the drone launcher.
      Drones from this drone orbit the other drones in turn.
      ie they become its targets.

    Change centripetal acceleration of drone launcher (see above)
    to get the satellites orbit their targets tightly (or loosely).

    Set drone lifetime and orbit insertion time of the drone
    launcher to set them for the launched drones.

  k - toggle snap to notes on selected drones.
	SHIFT + k - snap selected drones to notes.
	CTRL + k - unsnap selected drones to notes.

Modulation:

  F3 - toggle modulation target: voice or drones

  F7 & F8:  change FM (frequency modulation) rate in bpm of selected
            drones or all drones or voice.

  SHIFT + F7/F8: decrease/increase amount of change of FM rate in
                 bpm of selected drones or all drones or voice.

  CTRL + F7: set current FM rate as minimum.
  CTRL + F8: set minimum FM rate to 0

  F9 & F10: change AM (amplitude modulation) rate in bpm of selected
            drones or all drones or voice.


  SHIFT + F9/F10: decrease/increase amount of change of AM rate in
                  bpm of selected drones or all drones or voice.

  CTRL + F9: set current AM rate as minimum.
  CTRL + F10: set minimum AM rate to 0.
  
  r and t:  decrease/increase AM depth of selected drones or all drones
            or voice

  y and u:  decrease/increase FM depth of selected drones or all drones
            or voice
  
  or set from Menu > Voice and Menu > Drone Parameters

Phrasor:

  f - start/stop recording phrase
  v - play/pause phrase
  g - erase phrase

  or 

  Menu > Voice > Record a phrase
  
  Scrub with phrase position slider.

Delay:

  Click on the Delay button to toggle stereo delay lines.

  Change feedback & volume curves in the Delay editor (press 6 or
  choose Menu > Editors > Delay)

Gater:

  b - toggle gater or click on the Gater button

  Press 5 or choose Menu > Editors > Gater to edit beat shape.

  F5 & F6: decrease/increase gater bpm

  or set from Menu > Misc 

  Gater button flashes indicating beat shape.

Octave shift:

  z - shift down an octave
  x - shift up an octave

  F11 & F12: decrease/increase octave shift bpm

    SHIFT + F11/F12: decrease/increase amount of change of octave shift bpm
    CTRL + F11: set current octave shift bpm as minimum.
    CTRL + F12: set minimum octave shift bpm to 0

  Press 7 or choose Menu > Editors > Octave Shift to edit how tone changes to octave.
  Its possible to modulate to any other microtone instead of the octave by editing
  the octave shift curve.
  
Visual:

  SHIFT + i : toggle display of frequencies under notes and volume under mouse cursor OR
  Click on i at the bottom of microtonal-keyboard.

	SHIFT + j : toggle display of current frequency and volume for all drones OR
	Click on j at the bottom of the microtonal-keyboard.

  F2: Turn UI on or off.

	To resize ranges, use Menu > Misc > Adjust Range Left, Right and Both menu items.
	To change board height, use Menu > Misc > Adjust board height

Movement:

  a, d, w, s: left, right, down and up

  or Click on the arrow keys at the bottom of the microtonal-keyboard


Recording:

CTRL + ENTER - to start/stop sound recording
or Click on the Record button at the bottom of the microtonal-keyboard

ALT + ENTER - clear existing recording
or choose Menu > File > Clear

Menu > File > Save to save the recording as a .WAV file on the desktop.

Console:

TAB : enter/leave command mode
UP_ARROW / DOWN_ARROW: scroll up/down
SHIFT + UP_ARROW / DOWN_ARROW: scroll up/down command history

In command mode, type help to reveal available commands. Or type
help command_name to get help for a particular command.

PgUp, PgDn: page up, page down
BACKSPACE : delete all text in console
` : fold/unfold console
