-
Notifications
You must be signed in to change notification settings - Fork 129
/
VERSIONS
1708 lines (1563 loc) · 67.3 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.4.0.2
---
- (added) "global" declarations for int, float, string, Object, UGen, Event;
this can be used in-language across ChucK files (each file must first
"declare" the global value before using it). This also support usage from
external hosts such as Chunity. (thanks to Jack Atherton for this work!)
- (added) constant power panning (as controlled by the .pan parameter)
for all UGen_Stereo--including Pan2, stereo dac, stereo adc; this is
controllable using the new .panType parameter. By default, constant
power panning is NOT enabled for dac and adc, whose panning behavior
is unchanged (panType==0) and favors a kind of unity-gain-preserving
but perceptually suspect panning scheme. By contrast, Pan2 will default
to use constant power panning (panType==1). This will alter exist the
effect of any code that uses Pan2. Specifically, this will introduce
a ~3 dB reduction in the output Pan2 (it is possible to
restore the previous behavior by explicitly setting .panType to 0).
This ~3 dB reduction corresponds to the equal-powered amplitude value
when pan is at center (pan=0). Mathematically, the reduction amount
can be calculated using Std.lintodb(Math.cos(pi/4))
[To hear this new behavior, check out examples/stereo/stereo_noise.ck]
- (fixed) resolved a bug with SndBuf not playing when .rate < 0 and while
.pos beyond the end
- (fixed) resolved a bug with SndBuf where it could output DC when .rate < 0
after it reaches the beginning of the file (e.g., if the first sample is
non-zero)
- (deprecated) Chubgraph => (new) Chugraph;
Chubgraph will continue to function, with a deprecation warning.
- (documentation) updated embedded documentation text for all statically
linked UGens and libraries.
- (internal/refactor) the "Mega Merge 2021" integrates a long-standing
branch since REFACTOR-2017 that includes support for globals and was
the basis for Chunity. Future Chunity releases will align with mainline
ChucK language features. (thanks to Jack Atherton for several years of
laying the groundwork and for ChucK in Chunity!)
1.4.0.1
---
- (fixed) when opening audio input devices where the default
device has insufficient chanels (e.g., MacOS input is mono
by default), logic has been added to also match sample rates
when searching for alternate audio input devices; additional
logic added in the specific case of mono input devices to
simulate stereo, to fulfill the standard request for stereo
input.
- (fixed) added check to prevent crash in rare situations involving
self-join when deleting XThread in background. (git PR #103)
- (fixed) by stuntgoat@github -- right-recursion in chuck parser
can exhaust memory in larger chuck files; this has been updated
to use left recursion. (git PR #32, (finally) merged by hand by
Spencer and Ge) Also thanks to Tom Lieber for the initial analysis
and solution:
https://lists.cs.princeton.edu/pipermail/chuck-users/2009-April/004029.html
- (added) by Nathan Tindall -- Q and freq bounding for filters (LPF,
HPF, BPF, BRF) to avoid LOUD FILTER EXPLOSIONS; now negative values
will throw an exception on the offending shred.
- (restored, macOS) MAUI Chugin now (re)supported, post 1.4.0.0
- (added; developer) ChucK.h API to set a main thread hook (e.g., for
graphical functionalitie from Chugins)
- (updated, developer) Chugin API now support main thread callback
for graphical-/GUI purposes
- (developer) refactored code to move I/O-related code out of
chuck_lang and into chuck_io.
1.4.0.0
---
********************************************************
* NOTE: 1.4.0.0 is a simultaneous release with 1.3.6.0;*
* the two are identical except 1.3.6.0 also supports *
* earlier version of OS X before 10.9 (back to 10.5). *
********************************************************
* MAJOR SOURCE REFACTOR!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!*
* (Thanks Jack Atherton for months of groundwork!) *
********************************************************
- (added) support for 64-bit on windows
- (added) Chuck_External API for including and running ChucK from
elsewhere in C++
- specify the sample rate
- optionally specify the directory that me.dir() should
evaluate to; this dir will also be scanned for chugins
- optionally use custom callbacks for out and err messages
from ChucK
- (added) external keyword - for communicating variable values to and from
C++ code using Chuck_External API
- (developer) ChucK "core" as library, independent of external
system audio I/O; now much easier to embed ChucK as a
component in other hosts (e.g., command line, plugins, Unity, etc.)
- (developer) ChucK "host" (command line app)
- (developer) SOURCE: code support for multiple ChucK/VM instances
- (developer) SOURCE: one file to include them all (chuck.h)
- (developer) c_str() method for Chuck_Strings, so that chugins with a different
definition of std::string can still construct their own string
- (developer) API for chugin API calls
- now API variable must be passed
- SHRED variable must also occasionally be passed
- (internal) refactored Chuck_String representation to be immutable
- (internal) refactored to eliminate global VM, compiler, and env variables
- compiler stores a reference to env
- compiler stores a reference to vm
- vm stores a reference to env
- env stores its own top-level types; no more global type variables
- DL_Query stores a reference to compiler
- (internal) refactored all print statements to use new macros
1.3.6.0
---
- (see 1.4.0.0)
1.3.5.3 (unreleased; rolled into 1.4.0.0)
---
- (added) support for primitive type 'vec3' for 3D vector
- access .x .y .z OR .r .g .b OR .value .goal .slew
- (added) support for primitive type 'vec4' for 4D vector
- access .x .y .z .w OR .r .g .b .a
- (added) VM exceptions (e.g., ArrayOutOfBounds) now print line number
where possible (thanks Jack Atherton!)
- (added) Math.gauss( x, mu, sigma )
- (added) .clear() for Delay, DelayA, DelayL
- (fixed) - == and != for polar and complex types
- (fixed) repeat statement now worked correctly for shreds
- (fixed) crash with --adaptive:N and ugens that used tickf e.g. WvOut2
- (fixed) SndBuf occasional crash at end of file
- (fixed)(Win) install issue where chugins and/or example files were missing
- (removed) --blocking functionality; callback only for real-time audio
- (internal) refactored VM to be more friendly for integration
1.3.5.2
---
- (added) default root path changed from /usr to /usr/local
(fixes issues in Mac OS X 10.11 "El Capitan")
- (added) new ChuGins
- FoldbackSaturator
by Ness Morris
Foldback Saturator for nasty distortion.
- WPDiodeLadder
by Owen Vallis
Diode ladder filter based on Will Pirkle's technical notes.
- WPKorg35
by Owen Vallis
Korg 35 low-pass filter based on Will Pirkle's technical notes.
- (fixed)(Win) missing DLL issue
- (fixed) me.dir() issues with Machine.add()-ed shreds
- (fixed) crash fixes for <<< >>> with null objects
- (fixed) stop ignoring midi clock in midi messages
- (fixed) crash fix for array => ugen
- (fixed) fix OscOut send failure for programs that also use OscIn
1.3.5.1
---
- (added) new ChuGins
- PowerADSR
by Eric Heep
Power function ADSR envelope.
- WinFuncEnv
by Eric Heep
Envelope built on window functions.
- (added) more aggressive optimizations for ARM platforms
- (fixed) SndBuf fixes
- (fixed) SerialIO fixes:
- newline handling
- full-duplex IO
- general lag issues
1.3.5.0
---
- (added) new functions in Std
- int Std.clamp(int v, int min, int max)
Return v constrained to [min, max]
- float Std.clampf(float v, float min, float max)
Return v constrained to [min, max]
- float Std.scalef(float v, float srcmin, float srcmax,
float dstmin, float dstmax)
Scale v to range [dstmin, dstmax]. v is assumed to have the range
[srcmin, srcmax].
- float Std.dbtolin(float x)
Convert x dB to linear value
- float Std.lintodb(float x)
Convert linear value x to dB
- (added) MidiIn.open(string)/MidiOut.open(string) will open devices matched
by partial match if no full device-name match is found.
- (added) examples/osc/osc_dump.ck example
- (added) new static variables in ADSR
- .ATTACK, .DECAY, .SUSTAIN, .RELEASE, .DONE
values corresponding to current state, returned by ADSR.state()
- (added) full book/digital-artists examples
- (fixed) real-time audio hiccuping/underrun when loading files in SndBuf
- SndBuf .chunks now uses .chunks as buffer size for dynamic loading
- files are loaded .chunks samples at a time
- memory for the file is divided into buffers of .chunks samples
- chunk size defaults to 32768 samples
- (fixed) DLL issue on Win32 command line build
- (fixed) non-void functions implicitly return 0/null if no return statement
- (fixed) --probe crashes and other crashes related to error logging
- (fixed) include trailing slash in me.dir() and friends
- (fixed) fix me.path()/me.dir() for input paths with implicit .ck extension
- (fixed) better error messages for OscIn/OscOut
- (fixed) rare threading bug for OTF commands
1.3.4.0
---
- (added) chuck operator connects between arrays of ugens, multi-channel
ugens, and mono unit ugens
ex.
SinOsc s => Pan2 pan => Gain master[2] => dac;
persists stereo signal through master to dac.
See examples/stereo/array.ck for example usage.
- (added) new OSC support classes
- OscOut
Sends OSC messages
- .dest(string host, int port)
set destination hostname or IP address and port
- .start(string addr)
set target OSC address to addr
- .add(int i)
- .add(float f)
- .add(string s)
add argument to the message
- .send()
send message
- OscIn extends Event
Receives OSC messages
- int .port
port number to listen to
- .addAddress(string addr)
listen for OSC addresses matching addr
- .removeAddress(string addr)
stop listening for OSC addresses matching addr
- .listenAll()
listen for all incoming OSC messages on port
- int .recv(OscMsg msg)
retrieve pending OSC messages into msg. Returns 1 if a
message was available, 0 otherwise
- OscMsg
Encapsulates a received OSC message
- string .address
the OSC address this message was sent to
- string .typetag
the OSC typetag of this message
- int .getInt(int i)
- float .getFloat(int i)
- string .getString(int i)
retrieve the argument at position i of the given type
See examples/osc/ for examples on usage.
OscRecv and OscSend are still supported for backwards compatibility,
but new code should use OscIn and OscOut.
- (added) new SerialIO functions
- .writeByte(int b)
write byte b to the serial stream
- .writeBytes(int b[])
write array of bytes b to the serial stream
- (added) new chugins (from Joel Matthys)
- PitchTrack
Monophonic autocorrelation pitch tracker, based on [helmholtz~] by
Katja, http://www.katjaas.nl/helmholtz/helmholtz.html
- GVerb
Good quality stereo reverb with adjustable parameters
- Mesh2D
STK instrument that simulates a rectilinear, 2-dimensional digital
waveguide mesh structure. Basically sounds like striking a metal
plate.
- Spectacle
FFT-based spectral delay and EQ
- Elliptic
Elliptic filter, capable of very steep slopes or interesting
harmonic ripples
- (fixed) ChucK Shell fixes
1.3.3.0
---
- (added) PulseAudio support (via RtAudio)
- (fixed) relative path resolution for me.path() and me.dir()
- (fixed) C:/ style pathnames do not trigger spurious argument processing
- (fixed) MidiFileIn on Windows/Linux
1.3.2.0
---
- (added) --clear.vm flag
instructs remote VM to remove all shreds and clear public user types
- (added) Std.ftoi(float f)
Function for converting float to int
- (added) ASCII char literals - 'c' converted to int with ASCII value
- (added) book/digital-artists example programs for forthcoming book:
"Programming for Musicians and Digital Artists" (Manning
Publications)
(very special thanks to Mark Morris and Bruce Lott for sample
production)
- (added) new functions
- me.path()
equivalent to me.sourcePath()
- me.dir()
equivalent to me.sourceDir()
- me.dir(int N)
return Nth-level parent of source directory
- Shred.fromId(int id)
return Shred object corresponding to specified id
- (added) new functions for string objects
- .charAt(int index)
return character of string at index
- .setCharAt(int index, int ch)
set character of string at index to ch
- .substring(int pos)
return new string with characters from pos to end of string
- .substring(int pos, int len)
return new string with characters from pos of length len
- .insert(int pos, string str)
insert str at pos
- .erase(int pos, int len)
remove len characters from string, beginning at pos
- .replace(int pos, string str)
replace characters of string at pos with str
- .replace(int pos, int len, string str)
replace len characters of string with str, starting at pos
- .find(int ch)
search for character ch in string, return index of first instance
- .find(int ch, int pos)
search for character ch in string, return index of first instance
at or after index pos
- .find(string str)
search for string str in string, return index of first instance
- .find(string str, int pos)
search for string str in string, return index of first instance at
or after index pos
- .rfind(int ch)
search for character ch in string, return index of last instance
- .rfind(int ch, int pos)
search for character ch in string, return index of last instance
at or before index pos
- .rfind(string str)
search for string str in string, return index of last instance
- .rfind(string str, int pos)
search for string str in string, return index of last instance at
or before index pos
- (added) MidiFileIn class
Class for parsing + handling MIDI input from a file.
See examples/midi/playmidi.ck for example usage.
- .open(string filename)
Open file at specified path
- .read(MidiMsg inMsg)
Get next message in first track
- .read(MidiMsg inMsg, int trackNo)
Get next message in trackNo
- (added) SerialIO class (extends IO)
Class for communicating with serial devices, e.g Arduino.
See examples/serial/ for example usage.
- .list() (static)
return array of strings corresponding
to available serial IO devices
- .open(int i, int baud, int mode)
open device with index i. baud can be a constant specifying
which standard serial baud rate is used (e.g.
SerialIO.B9600). mode can be SerialIO.ASCII or
SerialIO.BINARY to specify ASCII or binary interpretation
of serial data.
- .onLine()
- .onByte()
- .onBytes(int num)
- .onInts(int num)
- .onFloats(int num)
chuck to now to wait for that type of data to arrive (in the
specified quantity). E.g. serial.onLine() => now; will wait
for 1 newline-terminated string to arrive from the serial
device.
- .getLine()
.getByte()
retrieve data requested as above as string/byte
- .getBytes()
.getInts()
.getFloats()
retrieve data requested using the onLine()/etc. above. as array
of data type
- .baudRate()
.baudRate(int baud)
get/set baud rate
- SerialIO.B2400
SerialIO.B4800
SerialIO.B9600
SerialIO.B19200
SerialIO.B38400
SerialIO.B7200
SerialIO.B14400
SerialIO.B28800
SerialIO.B57600
SerialIO.B115200
SerialIO.B230400
available baud rates
- (added) Regex class
Class for regular expression matching and replacing in strings.
Regex style is POSIX-extended.
- RegEx.match(string pattern, string str)
Return true if match for pattern is found in str, false otherwise
- RegEx.match(string pattern, string str, string matches[])
Same as above, but return the match and sub-patterns in matches
matches[0] is the entire matched pattern, matches[1] is the first
sub-pattern (if any), and so on.
- RegEx.replace(string pat, string repl, string str)
Replace the first instance of pat in str with repl, returning the
result.
- RegEx.replaceAll(string pat, string repl, string str)
Replace all instances of pat in str with repl, returning the
result.
- (fixed) --adc:<N> now works as expected
- (fixed) FileIO => string bug
- (fixed) LiSa.sync/LiSa.track now works when set to
1 (playhead follows input, normalized/rectified to [0,1])
2 (playhead follows input, non-normalized/rectified)
affects examples/special/LiSa-track*.ck
- (fixed) LiSa interpolation bug
- (fixed) .clear() function of arrays properly removes all items of the array
- (fixed) != properly handles comparison between a string and literal null
- (fixed) multichannel refcounting bug
- (fixed) WvOut performs IO writes on separate thread, significantly
minimizing audio underruns
- (fixed) crash in Chorus destructor
- (fixed) crash in Mandolin destructor
- (fixed) ADSR correctly initialized in "DONE" state
1.3.1.3
---
- (fixed) number in --dac:<N> flag is no longer off by one (this bug
was introduced in 1.3.1.2)
1.3.1.2
---
- (added) chuck now automatically detects and uses next highest
or closest (in that order) system sample rate in
the case where the default is not available; if a sample
rate requested via --srate: is not available, an error
will be encountered with a message.
- (fixed) base parent object is correctly accounted for by
new shred when sporking member functions
(thanks to Michael Heuer for reporting and
narrowing this down)
- (fixed) popping local variables from the operand stack in cases
where the datatype size is larger than int-size; this
is a bug introduced with 64-bit in 1.3.1.0, and exhibited
on 32-bit systems only. (thanks to Simon Steptoe
reporting and narrowing this down)
- (fixed) opening real-time audio with 0 input channels should
now work, once again.
1.3.1.1
---
- (fixed) critical bug since 1.3 where member function calls in
loop conditionals caused crashes when the loop body
contained local Object's to be released; this directly
affects using OSC, MIDI, HID, which commonly employ
syntax like: 'while( e.nextMesg() ) { ... }';
-- this is most likely the cause of the OSC-related issues
we've been seeing (thanks to Graham Coleman for tracking
down and narrowingthe issue!)
- (fixed) strengthened synchronization in OSC between internal
listener thread and chuck VM code
- (fixed) memory bug in OscRecv deallocation
- (fixed) Machine.add( ... ) on windows now supports both '\\'
and '/' in aboslute paths (previously only '\\').
(thanks to Graham Coleman for finding this!)
---
1.3.1.0
- (added) 64-bit support for all platforms (OS X, Linux, Windows)
many thanks to Paul Brossier, Stephen Sinclair,
Robin Haberkorn, Michael Wilson, Kassen, and
Fernando Lopez-Lezcano, and chuck-users!
- (added) Math.random(), random2(), randomf(), random2f(), srandom(),
and Math.RANDOM_MAX; NOTE: randomf() returns range 0.0 to 1.0
these use the much better random() stdlib functions
the existing Std.rand*() and Std.srand() is still
be available for compatibility (these to be deprecated
in the future; please start using Math.random*())
* (NOTE: on windows, Math.random() still uses the same
generator as Std.rand() -- we hope to improve this in
a future version!)
* (NOTE: also see removed below)
- (added) chuck --version | chuck --about now print architecture
(32-bit or 64-bit)
- (added) Machine.intsize() will return int width in bits (e.g., 32 or 64)
- (added) examples/array/array_mmixed.ck to verify mixed-index
fix (see below), based on Robin Haberkorn's test code
- (fixed) multi-dimensional arrays now correctly support mix-typed
indices (e.g., strings & ints) (thanks Robin Haberkorn)
- (fixed) constants in Math library now cleaner, they include:
* Math.PI
* Math.TWO_PI
* Math.e or Math.E
* Math.i or Math.I or Math.j or Math.J // as 'complex' type
* Math.INFINITY
* Math.RANDOM_MAX
* Math.INT_MAX // currently, differs on 32-bit and 64-bit systems
* Math.FLOAT_MAX
* Math.FLOAT_MIN_MAG // minimum positive float value
- (fixed) Chubgraph.gain(), .last(), and .op()
- (fixed) error message printing system for variable arguments
- (fixed) StifKarp.sustain now works properly
- (fixed) all examples now use Math.random*() instead of Std.rand*()
- (removed) Math.rand*() removed --> please use Math.random*();
(see 'added' above; Std.rand*() still there, but to be
deprecated; please use Math.random*() moving forward)
---
1.3.0.2
- (fixed) string literal reference counting
- (fixed) chuck to function call reference counting
---
1.3.0.1
- (fixed) WvOut no longer only record silence
- (fixed) WvOut.closeFile() does not cause the VM to hang
---
1.3.0.0
- (added) Chugins: dynamically loaded compiled classes/ugens
see http://chuck.stanford.edu/extend/ for examples.
- (added) new command line options
--chugin-load:{auto|off} disable/enable chugin loading
-gFILE/--chugin:FILE load chugin at FILE
-GPATH/--chugin-path:PATH load all chugins in directory PATH
--dac:NAME use dac with name matching NAME
--adc:NAME use adc with name matching NAME
- (added) Chubgraphs: create ugens by compositing existing UGens
see examples/extend/chubgraph.ck
- (added) ChuGens: create ugen by implementing audio-rate processing in ChucK
see examples/extend/chugen.ck
- (added) new ugens:
- WvOut2: stereo uncompressed audio file output
- SndBuf2: stereo uncompressed audio file input
- (added) new functions:
- me.sourcePath()
returns file path of source file corresponding to this shred
- me.sourceDir()
returns directory of source file corresponding to this shred
- MidiIn.open(string name)
open MIDI input matching name
- MidiOut.open(string name)
open MIDI output matching name
- Hid.open(string name)
open HID matching name
- (added) experimental OS X multitouch HID
- (fixed) real-time audio on Mac OS X 10.7 (Lion), 10.8 (Mountain Lion)
- (fixed) IO.newline() now flushes "chout"
- (fixed) "chout" and "cherr" now invoke member functions correctly
- (fixed) no for statement conditional handled correctly
- (fixed) STK WvOut correctly handles case when file open fails
- (fixed) << operator for arrays now correctly references counts
- (fixed) crashing bug when receiving external events at a high-rate
("the OSC bug")
- (fixed) scope closing correctly dereferences local objects
- (fixed) crash when exiting shreds with connected ugens
- (fixed) deallocation of "empty" Shred object no longer crashes
- (fixed) crash when HID events are sent to an exited shred
- (fixed) destructors for built-in objects are executed
---
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