-
Notifications
You must be signed in to change notification settings - Fork 4
/
Copy pathVERSIONS
1158 lines (1031 loc) · 41.5 KB
/
VERSIONS
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
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
---
1.2.1.3
- (added) initial/experimental support for file I/O (finally)
(thanks to Andrew Schran, Martin Robinson)
- (added) new class: IO, FileIO
see examples/io/:
read-int.ck
read-str.ck
readline.ck - using readline
write.ck - write using <=
write2.ck - write using .write()
- (added) IO input via =>
- (added) IO output via <= (the "back-chuck")
example: fio <= x <= " " <= y <= "\n";
- (added) new syntax for checking if/while/for/until with IO objects
e.g., while( fio => i ) { ... }
- (added) StdOut/StdErr objects:
"chout" (pronounced "shout")
"cherr" (pronounced "Cher")
- (added) Hid.open() now can accept a device name parameter
- (added) analysis/tracking examples are now back
(thanks to Kassen for looking into this)
- (fixed) calling overloaded functions with most specific match
e.g., Specific extends General:
fun void foo( General obj ) { }
fun void foo( Specific obj ) { }
foo( obj $ Specific ); // should call foo( Specific )
(thanks to Robert Poor for reporting, to Kassen, David Rush,
Michael Heuer, and Andrew C. Smith for follow-up)
- (fixed) STK instruments control changes reports range issues as
"control value exceeds nominal range"; previously printed
hard-coded values that were potentially misleading
(thanks to Kassen for reporting)
- (fixed) all oscillators now produce audio for negative frequencies
(thanks to Luke Dahl)
- (fixed) incorrect UGen disconnect (thanks Kassen for reporting)
- (fixed) type checker now validates if/while/for/until types
- (fixed) linux compilation (for gcc 4.x)
- (fixed) complilation on OS X Snow Leopard
---
1.2.1.2
- (added) dynamic, resizable arrays
.size( int ) resizes array; .size() returns current size()
<< operator appends new elements into array
.popBack() pops the last element of the array, reducing size by 1
.clear() zero's out elements of the array
(see examples/array/
array_dyanmic.ck
array_resize.ck)
- (added) new UAna: FeatureCollector
turns UAna input into a single feature vector, upon .upchuck()
new UAna: Flip
turns audio samples into frames in the UAna domain
new UAna: pilF
turns UAna frames into audio samples, via overlap add
new UAna: AutoCorr
computes the autocorrelation of UAna input
new UAna: XCorr
computes the cross correlation of the first two UAna input
- (added) UGen.isConnectedTo( Ugen ) // is connected to another ugen?
- (added) UAna.isUpConnectedTo( UAna ) // is connected to another uana via =^?
- (added) int Shred.done() // is the shred done?
int Shred.running() // is the shred running?
- (added) int Math.ensurePow2( int )
- (added) Math.INFINITY, Math.FLOAT_MAX, Math.FLOAT_MIN_MAG, Math.INT_MAX
- (added) TriOsc.width(), PulseOsc.width(), SawOsc.width(), SqrOsc.width()
- (added) Std.system(string) is now disabled by default, to enable: specify
the --caution-to-the-wind command line flag, for example:
%> chuck --caution-to-the-wind --loop
- (removed) SqrOsc.width( float ), width is always .5
- (fixed) it's now (again) possible to multiply connect
two UGen's
- (fixed) OS X only: sudden-motion-sensor HID no longer
introduces audio dropouts below peak CPU usage
due to added centralized polling;
added static Hid.globalPollRate( dur ) to control
the central SMS polling's rate
- (fixed) Windows only: implementation of array via STL vector::reserve()
has been replaced with a more compatible approach (see chuck_oo.cpp)
- (fixed) dac amplitude no longer halved!
NOTE: this increases the gain from before by
a factor of 2, or roughly 6 dB!! BEWARE!!
- (fixed) corrected order of shred/ugen dealloc in VM destructor,
preventing a potential crash during shutdown
- (fixed) UAna can now upchuck() at now==0
- (fixed) STK Chorus UGen now has reasonable defaults
.max( dur, float ) for initializing to delay/depth limits
.baseDelay( dur ) sets current base delay
- (fixed) dur +=> now no longer crashes
- (fixed) ADSR now returns attackTime, decayTime, and releaseTime that corresponds
to the duration-based setting functions (internally multiplied by SR)
(thanks Eduard)
- (fixed) STK Mandolin no longer plays without explicit noteOn
- (fixed) unsporked Shred instances now given id == 0 (thanks Kassen)
- (fixed) typos in ugen_xxx.cpp and chuck-specific rtaudio.cpp (/moudi)
---
1.2.1.1
- (fixed) ctrl-c no longer causes crash on shutdown
(was due to memory deallocation bug)
- (fixed) incorrect code generation for multiple expressions in 3rd clause
of for loops (thanks to Eduard for tracking!)
- (fixed) Envelope now is able to ramp down (contributed by Kassen, Dr. Spankenstein,
kijjaz, and others on electro-music!)
---
1.2.1.0 : codename spectral
- (added) Unit Analyzers (UAna: prounced U-Wanna, plural UAnae)
(primary creators: Rebecca and Ge)
provides support for spectral processing,
information retrieval, generalized + precise audio analysis
- (added) new datatypes:
---------
complex: (real,imaginary)
example: #(3,4) is complex literal (3,4)
example: #(3,4) => complex value;
access components via value.re and value.im
used by UAnae
polar: (modulus, phase)
example: %(.5, pi/4) is magnitude .5 and phase pi/4
example: %(.5, pi/4) => polar bear;
access components via bear.mag and bear.phase
used by UAnae
----------
example: can cast between complex and polar via standard $ casting
- (added) new UAna's:
----------
(authors: Rebecca and Ge)
FFT: Fast Fourier Transform
input: from UGen (manually input float vector)
output: complex spectrum (.cval()/.cvals())
magnitude spectrum (.cval()/.fvals())
(see examples/analysis/)
IFFT: Inverse FFT
input: UAna/Blob complex vector (spectrum)
output: to UGen (as samples)
(see examples/analysis/)
Centroid: Centroid feature extractor
input: UAna/Blob float vector (mag spectrum)
output: single centroid value per frame
(see examples/analysis/features/)
Flux: Flux feature extractor
input: UAna/Blob float vector (mag spectrum)
output: single flux value between current and previous frame
(see examples/analysis/features/)
RMS: RMS feature extractor
input: UAna/Blob float vector (mag spectrum)
output: single RMS value of frame
(see examples/analysis/features/)
RollOff: RollOff feature extractor
input: UAna/Blob float vector (mag spectrum)
percentage threshold
output: single RollOff value of frame
(see examples/analysis/features/)
----------
- (added) capability to externally abort "infinite loop" shreds
(this deals with hanging shreds due to potentially
infinite loops that don't advance time)
- (added) OTF command: chuck --abort.shred sends network OTF
to server to remove current shred if there is one
- (added) default .toString() method to all Object's
- (added) adding an Object to string will first cast object to string;
then add the two
- (added) LiSa.duration() get method, and .voiceGain() set/get
(Dan Trueman)
- (added) alternate line comment: <-- same as //
example:
SinOsc s => dac; <-- here is a comment
- (fixed) NullPointerException when instantiating array of objects
containing arrays of objects
(thanks to chuck-users!!)
- (fixed) Machine.remove() on parent shred id no longer crashes
- (fixed) Machine.remove() on 'me' now works correctly
- (fixed) rounding when writing files via WvOut
(thanks to Chris Chafe for discovering and reporting this)
- (changed) default frequencies (220/440) added for various STK instruments
(there is no version 1.2.0.9!)
---
---
1.2.0.8
- (added) command line argument support
e.g. %> chuck foo.ck:1:hello bar:2.5:"with space"
also works with OTF commands
e.g. %> chuck + foo:1:yo
also works with Machine.add( ... )
e.g. // code
Machine.add( "foo:1:2:yo" );
(see examples/basic/args.ck for accessing from code)
- (added) OS X: watchdog enabled
win32: watchdog implemented and enabled
(combats chuck infinite empty loop implosion)
- (added) OTF server/listener now ON by default...
to enable, specify --loop or --server
to disable, specify --standalone
- (added) new UGens:
--------
Dynamics: dynamics processor (compressor, expander, etc.)
(author Matt Hoffman and Graham Coleman)
(see examples/special/)
GenX: classic + new lookup table functions base class
(author Dan Trueman, ported from RTCMix)
(see examples/special/)
float .lookup( float ) : lookup table value
float[] .coeffs( float[] ) : load the table
Gen5 (extends GenX)
Gen7 (extends GenX)
Gen9 (extends GenX)
Gen10 (extends GenX)
Gen17 (extends GenX)
CurveTable (extends GenX)
WarpTable (extends GenX)
LiSa: (Li)ve (Sa)mpling!
(author Dan Trueman, partly based on Dan's munger~)
--------
- (added) (prototype) string catenation
(for now will leak memory! use wisely!!!)
e.g. // expression
"a" + "b"
"a" + 45
"a" + 5.1
"postfix" +=> str;
- (added) string escape sequences
\0 \n \t \a \" \b \f \r \v \\
\nnn (3 digit octal ascii)
- (added) new Objects:
--------
StringTokenizer: uh string tokenizer (by whitespace)
(use to be hidden PRC object)
see examples/string/token.ck
ConsoleInput: interim console input (until file I/O)
(use to be hidden Skot object)
see examples/string/readline.ck
--------
- (api) API additions
-------- (also see API modifications below)
ADSR: dur attackTime()
dur decayTime()
dur releaseTime()
WvOut: void closeFile()
Hid: void openTiltSensor()
int read( int, int, HidMsg )
HidMsg: int isWheelMotion()
(support for mouse scroll wheels)
int key
(cross-platform USB HID Keyboard Usage code)
int ascii
(ASCII value of key, where appropriate)
--------
- (api) API modifications (sorry!)
--------
ADSR: float attackTime( float ) -> dur attackTime( dur )
float decayTime( float ) -> dur decayTime( dur )
float releaseTime( float ) -> dur releaseTime( dur )
--------
- (api) deprecated --> new classes
--------------------------
HidIn --> Hid
- (fixed) adc.last() now returns correct value (was returning 0)
- (fixed) array is now subclass of Object
- (fixed) accessing null array no longer crashes (instead: exception)
- (fixed) allow: 0 length float arrays
- (fixed) check for negative array size
- (fixed) accessing null map no longer crashes (instead: exception)
- (fixed) connecting null UGen references no longer crashes
- (fixed) trivial (null == null) no longer evaluated as string
- (fixed) strict (x,y) => z type checking
- (fixed) UGens no longer able to make duplicate connections
- (fixed) && now terminates early if an operand evaluates to 0
|| terminates early if an operand evaluates to 1
- (fixed) bug accessing static members of built-in classes
- (fixed) OscSend.startMsg no longer silently fails when
using a single string message specification
- (fixed) Math.atan2 now accepts the proper arguments
- (fixed) increased OTF command network fail-safe measures
- (fixed) STK BlitSquare now produces correct frequency
(applied fix from STK release)
- (fixed) no longer spontaneously crashes when HidIn and
other event based input mechanisms are firing rapidly
- (fixed) using non-static variables from inside static functions
- (fixed) variables must be declared before being used
---
1.2.0.7b
- added: (all) HidIn.name() now returns meaningful device name
- fixed: (all) fixed STK Envelope bug
- fixed: (osx) mouse motion now correctly returns delta Y
- fixed: (win32) joystick hat messages now properly reported
- fixed: (win32) fixed bug where joysticks of same model/product
id would send messages through the same HidIn object
- fixed: (all) seg fault in OSCSend.startMsg() with single
string message specification
---
1.2.0.7
- (api) deprecated --> new classes
--------------------------
sinosc --> SinOsc
triosc --> TriOsc
sqrosc --> SqrOsc
sawosc --> SawOsc
pulseosc --> PulseOsc
phasor --> Phasor
osc --> Osc
noise --> Noise
cnoise --> CNoise
impulse --> Impulse
step --> Step
halfrect --> HalfRect
fullrect --> FullRect
gain --> Gain
zerox --> ZeroX
delayp --> DelayP
sndbuf --> SndBuf
pan2 --> Pan2
mix2 --> Mix2
onepole --> OnePole
onezero --> OneZero
polezero --> PoleZero
twopole --> TwoPole
twozero --> TwoZero
biquad --> BiQuad
**** --> ****
std --> Std
math --> Math
machine --> Machine
--------------------------
- (added) --deprecate:X flag
X can be stop, warn, or ignore - default is warn
- (added) STK BiQuad get functions pfreq, prad, zfreq, zrad
- (added) ADSR functions:
void .set( dur a, dur d, float s, dur r );
void .set( float a, float d, float s, float r );
- (added) new UGens (adapted from SC3 Server, Pure Data, CSound)
--------------------------
LPF : resonant lowpass filter (2nd order butterworth)
HPF : resonant highpass filter (2nd order butterworth)
BPF : bandpass filter (2nd order butterworth)
BRF : bandreject filter (2nd order butterworth)
ResonZ : resonant filter (BiQuad with equal-gain zeros)
FilterBasic : base class to above filters
--------------------------
- (added) new HidIn static variables for HidMsg message and device types
- (added) HidMsg fields to determine device type and number
- (added) HidMsg functions with capitalization rather than underscores
(underscored functions deprecated)
- (added) .period for all oscillators
- (fixed) floating point denormals no longer cause potentially
massive CPU usage on intel processors, this includes
BiQuad, OnePole, TwoPole, PoleZero, JCRev, PRCRev, NRev
- (fixed) STK Echo.max no longer gives incorrect warnings
- (fixed) linux makefiles now respects CC/CFLAGS/CXX (Cedric Krier)
- (fixed) SinOsc/TriOsc/PulseOsc/SqrOsc/Phasor.sync now unified:
.sync == 0 : sync frequency to input
.sync == 1 : sync phase to input
.sync == 2 : fm synth
|
NOTE: the above changes may break/affect existing patches
using TriOsc, PulseOsc, or SqrOsc
- (fixed) TriOsc/PulseOsc/SqrOsc phase consistent with convention
- (fixed) ADSR now handles keyOff() before sustain state
- (fixed) ADSR now correctly inherits Envelope
---
1.2.0.6 (more)
- (added) support for Mac OS X universal binary
- (added) executable now reports targets:
> chuck --version
chuck version: 1.2.0.6 (dracula)
exe target: mac os x : universal binary
http://chuck.cs.princeton.edu/
---
1.2.0.6
- (added) support for Mac OS X on Intel: (make osx-intel)
- (added) win32 - boost thread priority default from 0 to 5
- (added) Mandolin.bodyIR( string path ): set body impulse response
- (added) HID: support for mouse input on OS X, Windows, Linux
through 'HidIn' class
- (added) HID: support for keyboard input on OS X, Windows
through 'HidIn' class
- (added) new HID examples:
hid/mouse-fm.ck
/keyboard-flute.ck
- (added) OS X: --probe human-readable MIDI names
(thanks to Bruce Murphy)
- (fixed) multiple declarations now behave correctly:
(example: int a, b, c;)
- (fixed) now possible to spork non-static member functions
(example: Foo foo; spork ~ foo.go();)
- (fixed) sporking fixed in general
- (fixed) pre/post ++/-- now work correctly
(example: int i; <<< i++ + i++ * ++i >>>;)
- (fixed) public classes can now internally reference non-public
classes in the same file
- (fixed) obj @=> obj now ref counts correctly
- (fixed) STK Mandolin.detune( float f ) changed
- (fixed) STK Mandolin.damping( float f ) changed
---
1.2.0.5b
- (fixed) adc bug
- (fixed) %=> bug
---
1.2.0.5
- (added) multi-channel audio
- use --channels<N> or -c<N> set number of channels
for both input and output
- use --out<N>/-o<N> and --in<N>/-i<N> to request
# of input and output channels separately
- stereo is default (for now)
- (added) UGen.channels()
- (added) class UGen -> class UGen_Multi -> class UGen_Stereo
- (added) UGen UGen_Multi.chan( int )
use this to address individual channels
- (added) examples in examples/multi
- n.ck : n channels detuned sine
- i.ck : n channels impulse
- (added) HID support (author: Spencer Salazar)
- (added) 'HidIn' event class (see examples/hid/*.ck)
- (added) Terminal Keyboard Input (immediate mode, separate from HID)
- (added) 'KBHit' event class (see examples/event/kb*.ck)
- (added) sndbuf.chunks : better real-time behavior
- can be set to arbitrary integers
(before the .read happens)
- default is 0 frames (no chunk)
- set .chunks to 0 to read in entire file
(previous behavior)
- (added) int math.isinf( float ) // infinity test
- (added) int math.isnan( float ) // NaN test
(see examples/basic/infnan.ck)
- (added) sndbuf.valueAt( int ) for returning sample at arbitrary pos
(see examples/basic/valueat.ck)
- (added) MASSIVE STK UPDATE
- (added) 'StkInstrument' class
.noteOn( float )
.noteOff( float )
.freq( float ) / .freq()
.controlChange( int, float )
- (added) the following now extend 'StkInstrument'
(most of them have additional parameters)
- BandedWG
- BlowBotl
- BlowHole
- Bowed
- Brass
- Clarinet
- Flute
- FM (and all its subclasses: BeeThree, FMVoices,
HevyMetl, PercFlut, Rhodey, TubeBell, Wurley)
- Mandolin
- ModalBar
- Moog
- Saxofony
- Shakers
- Sitar
- StifKarp
- VoicForm
- (added) better STK documentation
http://chuck.cs.princeton.edu/doc/program/ugen.html
- (added) examples/stk/modulate.ck
- (added) --watchdog and --nowatchdog flags
(very experiment watchdog for real-time audio)
- (added) () => function; // calls function();
(thanks to Mike McGonagle for reporting)
- (added) if exp: ( cond ? if_cond : else_cond )
(thanks to Mike McGonagle for reporting)
- (added) math.abs( int ), math.fabs( float ), math.sgn( float )
(std version unchanged)
- (added) new examples
- basic/infnan.ck
/fm.ck fm2.ck fm3.ck
/valueat.ck
- event/kb.ck kb2.ck
- hid/joy.ck
/joy-fm.ck
/joy-noise.ck
/joy-shake.ck
- multi/i.ck
/n.ck
/we-robot.ck
- osc/s.ck
/r.ck
- stk/bandedwg.ck
/blowbotl.ck
/blowhole.ck
/bowed.ck
/brass.ck
/clarinet.ck
/flute.ck
/mandolin.ck
/modalbar.ck
/saxofony.ck
/stifkarp.ck
- (fixed) sinsoc, triosc, sqrosc, phasor:
- .sync( 0 ) uses input signal to modulate frequency
- .sync( 2 ) uses input signal to modulate phase
(FM synthesis)
- (fixed) impulse.last() no longer has extra samp delay
(thanks to Mike McGonagle for reporting)
- (fixed) class inheritance now handles the first overloaded
function of a parent correctly when called using a
subclass instance. in other words, this part sucks
less now.
(thanks to Mike McGonagle for reporting)
- (fixed) (internal) type checker re-instantiation patched
- (fixed) (internal) detach_all() moved to chuck_globals.cpp
- (fixed) (internal) global variables moved to chuck_globals.cpp
- (fixed) file handles close in compiler and parser
- (fixed) syntax error causing syntax errors
---
1.2.0.4
- (added) The ChucK Manual (pdf)
fantastic work by Adam Tindale and other documentors
see doc/Chuck_manual.pdf
- (added) Envelope.duration( dur ), Envelope.duration()
- (added) Envelope.keyOn(), Envelope.keyOff();
- (added) PitShift.mix( float ), PitShift.mix()
(originally effectMix)
- (added) std.srand( int ) : seed random number generator
- (added) update to RtAudio 3.2.0 -> much lower latency: Window DS
(thanks to Gary Scavone and Robin Davies)
- (added) update to RtMidi 1.0.4 -> improved midi: linux ALSA
(thanks to Gary Scavone and Pedro Lopez-Cabanillas)
- (added) bandlimited ugens: Blit, BlitSaw, BlitSquare
(thanks to Robin Davies for implementation,
Gary Scavone for putting them in STK)
- (added) examples/basic/foo.ck foo2.ck tick.ck tick2.ck
(foo2 shows using Blit, tick.ck is a simple counter)
- (added) examples/class/dinky.ck try.ck
(creating and using class to make instruments)
- (fixed) sndbuf.read now closes file handle and sets curf
- (fixed) default bufsize=256 under OSX and 512 under all other
- (fixed) chuck + foof garbled error message
- (fixed) chuck.lex compatibility under some linux
- (fixed) waiting on null event: no longer crashes VM
- (fixed) function arguments: no longer allow reference to primitive types
- (fixed) function: correctly select overloaded functions w/ implicit cast
- (fixed) std.atoi() std.atof(): no longer crash on null string
- (fixed) std.fabs(): now works correctly
- (fixed) basic/moe.ck larry.ck currly.ck use fabs
- (fixed) missing base class virtual destructors;
FreeBSD/g++ compatibility (thanks rasmus)
- (fixed) most -Wall warnings
- (fixed) CK_LOG_SYSTEM_ERROR now CK_LOG_CORE
---
1.2.0.3
(API changes again)
(syntax change - 'loop' -> 'repeat')
- loop( ... ) construct (see 1.2.0.2) changed to repeat( ... )
- usage and semantics same as before
- this is also an experimental language feature
(let us know if it's good or bad)
- float std.abs( float ) changed -> int std.abs( int )
- use std.fabs( ... ) for floating point absolute value
- (added) /* block comments */
- no nesting allowed
- closing '*/' not necessary if commenting out rest of the file
- (fixed) arrays of null object references correctly allocated
: Event @ events[128];
- (fixed) DEFAULT sndbuf rate now set correctly to interpolate
for files outside of chuck sample rate (no longer have to
explicit do 1 => buf.rate)
- (fixed) examples/midi/polyfony*.ck no longer creates 128
unnecessary events...
- (changed) examples/stk/wurley.ck -> examples/stk/wurley2.ck
- (changed) examples/stk/wurley.ck (wacky version)
---
1.2.0.2 - 2005.10.17
(sorry for the API changes)
- (API change) OSC_Send class name changed to 'OscSend'
(also): .startMesg(...) name changed to startMsg(...)
- (API change) OSC_Recv class name changed to 'OscRecv'
- (API change) OSC_Addr class name changed to 'OscEvent'
(also): .hasMesg() name changed to .hasMsg()
(also): .nextMesg() name changed to .nextMsg()
- (API change) STK Shakers.freq now expect Hz instead of MIDI number
- (moved) examples/event/opensound*.ck moved to examples/osc/OSC*.ck
(see OSC_send.ck and OSC_recv.ck for examples on OpenSoundControl)
- (moved) examples/event/polyfony*.ck to examples/midi/
- (added) 'loop(...){ }' control structure :
example: loop( 8 ) { ... } // executes body 8 times
example: loop( foo ) { ... } // executes body foo times
(foo is evaluated exactly once entering the loop, the
value at that time is used as a constant to control
loop iteration - even if foo is changed in the loop
body.)
- supports break and continue
- important: one fundamantal difference between the loop
semantic and for/while/until semantic is that the argument
expression 'exp' in loop( exp ) is evaluated exactly once
when the loop is first entered.
- (added) MidiIn and MidiOut member functions:
.good() : whether the thing is good to go (int)
.num() : the device number (int)
.name() : the device name (string)
.printerr( int ) : whether to auto print errors (default YES)
- (added) --version command line flag (Graham)
- (changed) chuck --status now prints shreds sorted by id
(previously it was the current shreduling order + blocked)
- (changed) a udp port may now be shared by many OSC_Recv (phil)
: the incoming messages are broadcast to all
- (changed) address/type string in OSC: comma now optional (phil)
- (fixed) events are now 0-sample synchronous (instead of 1)
- (fixed) startup audio stability for --callback mode
- (fixed) incorrect 'continue' behavior in for loops
- (fixed) improved OSC stability (phil)
- (fixed) OSC shreduling sanity check failed now resolved
- (fixed) math.round for negative numbers (win32)
- (fixed) std.mtof and std.ftom now internally double precision
- (fixed) removed extra console output in STK Flute
- (fixed) multiple delete/assertion failure on type rollback
- (fixed) chuck --kill now closes WvOut and MidiRW file handles
- (added) examples/midi/gomidi.ck : very useful sometimes
- (added) examples/midi/gomidi2.ck
- (added) examples/basic/rec-auto.ck (rec2.ck back in action)
- (added) examples/basic/fmsynth.ck (from v1)
- (added) examples/sitar.ck
- (fixed) examples/stk/*-o-matic.ck now uses array
---
1.2.0.1 - 2005.9.27
- (added) full callback capability for real-time audio
- blocking functionality still available
- select via flags: --blocking and --callback
- improves latency and stability, especially on linux
- use --callback (default) for low latency / small buffer size
- use --blocking for higher throughput
- (fixed) crash when doing on-the-fly 'replace' : chuck --replace 0 foo.ck
- (fixed) OSC event function now correctly named ("event")
- (fixed) removed debug output in OSC
- (fixed) implicit cast is now correct when sporking (thanks to Manfred Brockhaus)
- (fixed) examples code reformatted, cleaned, and commented
- (fixed) nested class definitions can now have same name as outer class
- (fixed) nested class bug in scan1 (thanks to Robin Davies)
- (fixed) variable resolution in parent class now visible (thanks to Robin Davies)
- (fixed) variable resolution ordering
- local, class, parent, global (thanks to Robin Davies)
- (fixed) emitter now asserts inheritance instead of equality (thanks to Robin Davies)
- (fixed) string comparison ==, !=
- (added) string operations <, <=, >, >=
---
1.2.0.0
SYNTAX and OPERATORS:
- (added) +=>, operator : 2 +=> i; (also) -=>, *=>, /=>, %=>
- (added) @=> for explicit assignment
this is the only way to make object reference assignments
- (added) implicit int to float casting
- (changed) cast now look like: 1.1 $ (int) => int i;
- (added) function call by chucking :
// call
(1,4) => math.rand2f => result;
// same as
math.rand2f(1,4) => result;
LANGUAGE:
- (fixed) type system for existing types
- (added) forward lookup of classes and functions (mutual recursion)
- (added) stack overflow detection for massive recursion
DOCUMENTATION:
- (added) language specification:
http://chuck.cs.princeton.edu/doc/language
COMMAND-LINE:
- (added) --probe prints all audio and MIDI devices
- (added) --log or --verbose logs compiler and virtual machine
- (added) --logN or --verboseN multi level logging
1 - least verbose
10 - most verbose
OBJECTS:
- (added) 'class' definitions : class X { int i; }
- (added) 'extends' keyword : class Y extends Event { int i; }
- (added) virtual/polymorphic inheritance
- (added) added pre-constructors - code at class level
gets run when object is instantiated
- (added) function overloading :
class X { fun void foo() { } fun void foo( int y ) { } }
- (added) base classes (can be extended):
Object, Event, UGen
see below
- (added) base classes (cannot be extended):
array, string
see below
- (added) member data
- (added) static data
- (added) member functions
- (added) static functions
EVENTS:
- (added) base Event class : Event e;
can be used directly
can be extended to custom events
(see one_event_many_shreds.ck)
- (added) waiting on event, chuck to now :
e => now; // wait on e
- (added) e.signal() wakes up 1 shred, if any
- (added) e.broadcast() wakes up all shreds waiting on e
- (added) class MidiEvent (see gomidi2.ck)
alternative to polling.
- (added) class OSCEvent
ARRAYS:
- (added) arrays : int a[10]; float b[20]; Event e[2];
- (added) multidimensional arrays : int a[2][2][2];
- (added) associative arrays : int a[10]; 0 => a["foo"];
all arrays are both int-indexed and associative
- (added) array initialization : [ 1, 2, 3 ] @=> int a[];
- (added) .cap() for array capacity
- (added) .find() test if item is associative array
- (added) .erase() erase item in associative array
UGENS:
- (added) class UGen
can be extended
- (changed) all ugen parameters are now also functions:
// set freq
440 => s.freq => val;
// same as...
s.freq( 440 ) => val;
- (changed) left-most parameters must now be called as functions
// no longer valid
f.freq => float val;
// valid
f.freq() => float val;
// still ok
440 => s.freq => float val;
SHREDS:
- (added) class Shred
- (added) .yield() .id()
STRINGS:
- (added) class string
AUDIO:
- (added) stereo
all stereo unit generators have .left, .right, .pan functions
- (changed) stereo ugen: dac (2 in, 2 out)
- (changed) stereo ugen: adc (0 in, 2 out)
- (added) stereo ugen: pan2 take mono or stereo input and pans
- (added) stereo ugen: mix2 mix stereo input into mono
---
1.1.5.6 - 2005.4.11
- last 1.1 release : contains all 1.1 changes
---
1.1.5.5 - 2005.2.10
- FIFO to RR for audio and synthesis - improves stability on OS X
- fixed stack underflow emitter bug with declarations
- fixed cpu sleep bug on win32
---
1.1.5.4 - 2004.11.18
- fixed clicks when using adc unit generator
(thanks to paul botelho for testing)
- added 'maybe' keyword
maybe == 0 or 1, with 50% probability each
new examples:
- maybe.ck : the maybe keyword - bad idea? maybe.
- maybecli.ck : maybe click, maybe not
adc examples work better:
- adc.ck
- echo.ck
- i-robot.ck
---
1.1.5.3 - 2004.11.4
- when a shred is removed from VM, all children shreds are
also recursively removed
(this fix crash due to removing shreds with active children shreds)
(to keep children around, put parent in infinite time-loop)
(this isn't always good - real solution coming soon)
- 'start' keyword now available - holds the a shred's begin time
updated examples:
- powerup.ck : start local variable changed name
- spork.ck : added infinite time loop to keep children active
---
1.1.5.2 - 2004.10.17
- crtical patch shreduler time precision
- same as 1.1.5.1 - see below
---
1.1.5.1 - 2004.10.15
- on-the-fly chuck files to remote hosts!
> chuck @hostname + foo.ck
> chuck @hostname -p<N> + foo.ck
- TCP replacing UDP for commands
- endian observed (mac <-> win32/linux)
- more sensible VM output for on-the-fly commands
- many on-the-fly bug fixes
- --replace: new shred inherits the replaced shred id
(useful to keep track of shreds in VM)
- sndbuf automatically set .rate to 1.0 (instead of 0.0)
(0.0 => buf.rate if no play on next time advance)
- new on-the-fly examples
new examples:
- otf_*.ck - illustrates precise on-the-fly timing
(adapted from Perry's ChucK drumming + Ge's sine poops)
chuck them one by one into the VM:
terminal 1%> chuck --loop
terminal 2%> chuck + otf_01.ck
(wait)
terminal 2%> chuck + otf_02.ck
(wait)
(repeat through otf_07.ck)
(remove, replace and add your own)
---
1.1.5.0 - 2004.9.29
- now able to write audio files (wav, aiff, raw)
(try rec.ck and rec2.ck concurrently with any other shreds
to record to disk)
- STK file endian is now observed (more things should work
on little endian systems)
- added 4 "special" built-in sound samples
"special:glot_pop" - glottal pulse (flat)
"special:glot_ahh" - glottal 'ahh' pop
"special:glot_eee" - glottal 'eee' pop
"special:glot_ooo" - glottal 'ooo' pop
(see/listen to moe++.ck, larry++.ck, curly++.ck)
- all bulit-in sound samples now loadable from both WaveLoop and sndbuf
- (win32) sndbuf now properly loads wav aiff
new examples:
- moe++.ck - stooges, evolved
- larry++.ck
- curly++.ck
- rec.ck - run this concurrently to write audio to file
(also try with -s flag for file out, no real-time audio)
- rec2.ck - same as rec, but writes to different file every time,
for sessions
---
1.1.4.9 - 2004.9.18
- all of STK is now in ChucK!
- new examples (see below)
- add '--bufnum<N>' to chuck command line (number of buffers)
- --status no longer prints full path for source
- full path now works for command line + (thanks Adam T.)
- minor bug fixes
- improved online ugen documentation (go phil!)
new ugens: (again, thanks to Phil Davidson!)
BandedWG (STK)
Blowhole (STK)
BlowBotl (STK)
Bowed (STK)
Brass (STK)
Clarinet (STK)
Flute (STK)
ModalBar (STK)
Saxofony (STK)
Sitar (STK)
StifKarp (STK)
delayp - variable write position delay line
new examples:
band-o-matic.ck - banded waveguide, automated
delayp.ck - shows usage
mode-o-matic.ck - modal bar, happy chaos
stifkarp.ck - stifkarp, chaos
---
1.1.4.8 - 2004.9.8
- added win32 visual studio support (chuck_win32.*)
- new oscillators (see below, thanks to Phil)
- corrected more issues on some 64-bit systems
- new examples (see below)
- chucking to oscillators now able to control phase
(alternative to doing FM by hand (1::samp at a time),
see pwm.ck and sixty.ck) (thanks to Phil)
new ugens:
triosc - triangle wave
pulseosc - pulse wave oscillator w/ controllable pulse width
sqrosc - square wave
sawosc - saw tooth
phasor - 0 to 1 ramp
new examples:
sixty.ck - shows osc's
pwm.ck - basic pulse width modulation
(you can still do FM "by hand" - see fmsynth.ck)
---
1.1.4.7 - 2004.9.4
- improved performance (reduce cpu overhead)
- fixed bug that caused crash on ctrl-c
- added sndbuf.play (same as rate)
- corrected issues on some 64-bit systems
- sndbuf.ck now works
---
1.1.4.6 - 2004.8.26
- added netin/netout unit generators (alpha version)
- added a lot of STK unit generators (thanks to philipd)
(over 80% of STK is now imported)
- fixed Shakers (thanks to philipd) : examples/shake-o-matic.ck
- better compilation for cygwin
- minor bugs fixes
- added many READ functionality for ugen parameters
see online documentation at:
http://chuck.cs.princeton.edu/doc/program/ugen.html
new ugens:
- netout (alpha version) - audio over UDP (see net_send.ck)
- netin (alpha version) - audio over UDP (see net_recv.ck)
- Chorus (STK)
- Envelope (STK)
- NRev (STK)
- PRCRev (STK)
- Modulate (STK)
- PitShift (STK)
- SubNoise (STK)
- WvIn (STK)
- WvOut (STK)
- BlowBotl (STK)
- FM group (STK)
- BeeThree
- FMVoices
- HevyMetl
- PercFlut
- TubeBell
new examples:
- shake-o-matic.ck - STK shakers going bonkers
- net_send.ck - oneway sender
- net_recv.ck - oneway recv
- net_bounce.ck - redirect
---
1.1.4.5 - 2004.8.14
- fixed bug for multiple declarations
- made functions local to shred by default
- shadowing now works
- add 'blackhole' ugen for ticking ugens
- added std.mtof (philipd)