-
Notifications
You must be signed in to change notification settings - Fork 2
/
README-2.txt
152 lines (105 loc) · 5.63 KB
/
README-2.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
//------------------------------------------------------------------------------
// BORDERLANDS: An interactive granular sampler.
//------------------------------------------------------------------------------
// Project website:
// http::/ccrma.stanford.edu/~carlsonc/256a/Borderlands/index.html
//
//
// Copyright (C) 2014 Christopher Carlson
// www.modulationindex.com
//
// These install instructions were last updated on Monday, May 26, 2014
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, version 3.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program. If not, see <http://www.gnu.org/licenses/>.
Thank you for downloading Borderlands!
//------------------------------------------------------------------------
// Installation:
//------------------------------------------------------------------------
Borderlands has been tested on Mavericks.
Please make sure the following libraries are installed on your system.
RtAudio is used for real-time audio I/O
http://www.music.mcgill.ca/~gary/rtaudio/
Libsndfile is used for loading .aiff and .wav files
http://www.mega-nerd.com/libsndfile/
Note: On OSX, I would recommend using Homebrew to install libsndfile, as it makes the process much easier:
http://brew.sh/
To install home-brew, paste this into Terminal and hit enter:
ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"
Once Homebrew is installed, type:
brew install libsndfile
If libsndfile installs correctly, continue installing the necessary libraries to run Borderlands as described below. If the libsndfile install wonÕt run (or requires admin privileges, try
sudo brew install libsndfile
ÑÑÑÑÑÑÑ
If you haven't already, download the source from http://ccrma.stanford.edu/~carlsonc/256a/Borderlands/index.html, unzip it,
navigate to the Borderlands directory in Terminal, and type make.
If all goes well, the source should compile. Note, on Mavericks, there may be a number of warnings due to glut functions being deprecated. If there are no error messages and only warnings, this should be fine.
If you get error messages, please email me at carlsonc AT ccrma DOT stanford DOT edu and I will try to help resolve any issues quickly!
//------------------------------------------------------------------------
// Before runningÉ
//------------------------------------------------------------------------
Put your favorite .wav and .aif files into the loops directory contained in the distribution.
These will be automatically loaded when you launch Borderlands.
//------------------------------------------------------------------------
// To launch the softwareÉ
//------------------------------------------------------------------------
Type ./Borderlands from the source directory in terminal. The screen will be black for
a bit while your audio files load, and then you will see a title screen with instructions.
//------------------------------------------------------------------------
// Controls
//------------------------------------------------------------------------
The user interaction is primarily mouse and keyboard based. Here are the main controls:
Entry/Exit
------------
ESC Quit
? key Hide/Show Title Screen
Rectangles
------------
Left click Select
Drag Move
TAB key Cycle selection of overlapping rectangles under mouse
R key + drag Resize
F key Flip orientation
Cloud Addition and Selection
------------
G key (+ shift) Add (remove) cloud to/from end of collection
Delete key Remove selected cloud
Left click Select
Drag Move
Cloud Parameters
------------
After selecting a cloud, parameters associated with the granular synthesis can be edited.
Most parameters involve keyboard interfacing. Select the key corresponding to the mode,
then press it again to change the value. In some cases, numeric keys are used to enter
specific values. In parameters associated with grain motion, the mouse is used.
V key (+ shift) Add (remove) voices
A key Toggle cloud on/off
D key (+ shift) Increment (decrement) duration
D key + numbers Enter duration value (ms) - press Enter to accept
S key (+ shift) Increment (decrement) overlap
S key + numbers Enter overlap value - press Enter to accept
Z key (+ shift) Increment (decrement) pitch
Z key + numbers Enter pitch value - press Enter to accept
W key Change window type (HANNING, TRIANGLE, EXPDEC, REXPDEC, SINC, RANDOM)
W key +
1 through 6 Jump to specific window type
F key Switch grain direction (FORWARD, BACKWARD, RANDOM)
R key Enable mouse control of XY extent of grain position randomness
X key Enable mouse control of X extent of grain position randomness
Y key Enable mouse control of Y extent of grain position randomness
//------------------------------------------------------------------------
// Acknowledgement
//------------------------------------------------------------------------
Thanks to Ge Wang and Jorge Herrera for their guidance through the initial stages
of this project. Thanks to Mike Rotondo his help in my early brainstorming discussions.
Thanks to Tarik Barri for encouraging me to pursue the idea and for suggesting the
use of the second dimension of the sound rectangles!