
DIN Is Noise 
Copyright (c) 2006-2020 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

` : switch between current instrument and last used editor

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 its pitch.
	Height of the drone is its volume.
	
	Press SHIFT + j to print pitch and volume of drones. Or
	click on j at the bottom of the microtonal-keyboard.

	Create:

		q - to 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.

	Select:

		Click & move to draw a box around the drones you'd like 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 CTRL to move only horizontally
				hold SHIFT to move only vertically

				moving horizontally changes pitch of selected drones.
				moving vertically changes volume of selected drones.
				moving both directions changes both pitch and volume.

			press e again or click or ESC to stop moving.

		Or

		choose Menu > Drone Tools > Move. 

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

			NUMPAD 4 - scale down
			NUMPAD 5 - scale up

		CTRL + e - rotate selected drones about their center

		Menu > Drone Tools > Rotate to rotate selected drones or

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


	Delete:

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

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

	Operations:

		For selected drones,

			- - decrease trail length
			= - increase trail length

			9 - decrease handle size
			0 - increase handle size

			j - freeze / thaw moving drones

			k - snap / unsnap drones to notes

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

			<- : browse previous drone
			-> : browse next drone

      , : reduce drone master volume
      . : increase drone master volume

      SHIFT + , : mute 
      SHIFT + . : unmute

		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 to 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 drone launchers

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

			[ - decrease speed of selected drones
			] - increase speed of selected 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 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)
			' - select the satellites orbiting the selected planets

			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.

	Modulation:

		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.

		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.

		F4: Switch modulation between Voice and Drones.
		
		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 Params

Voice / Noise:

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

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

	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:

  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

  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:

	INSERT:	toggle volume distribution display
	DELETE: toggle pitch distribution display

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

	CTRL + 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 > 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:

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.

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
