
DIN Is Noise 

Copyright (c) 2006-2023 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

For this and other, choose from Menu > Editors

` : switch between current screen and previous screen

Drone:

	A drone is a constant and continuous sound at some pitch 
	and volume (loudness). 
	
	Create drones on the microtonal-keyboard.

	Horizontal position of the drone is frequency.
	Height of the drone is volume.
	
	Press SHIFT + j to print pitch and volume of selected drones. Or
	click on j at the bottom of the microtonal-keyboard.

	Create:

		q - to add or wand drones. 

    or

    choose Menu > Drone Tools > Add / Wand. 

      when adding, click to add a drone, click and drag to spray 
      when wanding, just move mouse to add drones
        adjust distance to move before DIN wands a drone at 
          Menu > Drone Params > Defaults > Wand distance

    ESC or Right click to stop adding or wanding drones


	Select:

		Click & move to draw a box around the drones you want to select.
		Click to finish, ESC or right click to abort.

		l - select all drones

    i - invert selected drones

	Transform:

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

          hold SHIFT to move just vertically (only changes volume)
				  hold CTRL to move just horizontally (only changes frequency)

		    press e again or click or ESC to stop moving.

		or Menu > Drone Tools > Move. 

    f - find center of selected drones
          center marked by a pink cross

    r - rotate selected drones about their center

    or Menu > Drone Tools > Rotate

		t - scale selected drones about their center
			
			when using mouse slider, hold CTRL to scale 
      horizontally, hold SHIFT to scale vertically
		
		or Menu > Drone Tools > Scale

	Delete:

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

	Operations:

    / - change drone master volume

		For selected drones,

			= - change trail length 
			- - change handle size

			SPACE - freeze / thaw moving drones

			k - snap / unsnap drones to notes

				SHIFT + k - snap to notes.
				CTRL + k - unsnap from notes

			LEFT_ARROW - browse previous drone
			RIGHT_ARROW - browse next drone

		Drone launch:

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

			h - toggle selected drones into drone launchers

      SHIFT + l - select all launchers

			] - change velocity of selected drones
			CTRL + ] - toggle drawing of velocity vectors

			or set from Menu > Drone Params > Motion

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

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

			You can set the lifetime of the launched drone with Menu > Drone Params > 
			Motion > 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. 

			also,

			; - select the planet(s)
        or Menu > Drone Tools > Select attractors

			' - select the satellites orbiting the selected planets
        or Menu > Drone Tools > Select attractees

      [ - change acceleration of selected drones 

            if these are satellites, changes their acceleration 
            towards the 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 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.

	Modulation:

    Modulate Frequency and amplitude of Voice and drones. 

    Voice modulation in DIN is a classic modulation with a twist:
    a Bezier curve waveform on the carrier and a Bezier curve 
    waveform on the modulator! Depth is Hz, Rate is BPM. Happens 
    every sample!

    Drone modulation in DIN is 'visual modulation'. Amplitude modulation
    is change of drone's height on the microtonal keyboard over BPM. 
    Frequency modulation is change of drones's horizontal position 
    over BPM. The modulated position of a drone determines its 
    frequency and volume. Happens once every audio buffer.

    y, u : change AM depth, BPM of selected drones
    o, p : change FM depth, BPM of selected drones
		or set from Menu > Drone Params > Modulation

Voice / Noise:

	Click Voice (/ Noise) button at the bottom of the microtonal-keyboard 
  to turn on / off Voice (/ Noise).

	Phrasor:

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

		or 

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

Ranges:

	Please visit https://dinisnoise.org/docs/ and click on 
	Microtonal Range Reference.

FX:

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:
  
  Click on the Gater button to toggle the Voice/Noise gater. DIN
  applies the gater curve as an envelope over Voice/Noise.

  Press 5 or choose Menu > Editors > Gater to edit the 
  gater curve.

  Set BPM and looping style from Menu > Misc 

  Gater button flashes indicating beat shape.

Octave shift:

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

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

  Click on i to 
    toggle display of frequencies under notes of microtonal keyboard 
    and frequencies and volume under mouse cursor

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

  F2: Turn UI on or off.

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

Movement:

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

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

Recording:

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

choose Menu > File > Clear to clear existing sound recording.

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