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
|
<!---
To maintain this document use the following markdown:
n
# First level heading
## Second level heading
### Third level heading
- First level bullet point
- Second level bullet point
- Third level bullet point
`inline code`
``` pre-formatted text etc. ```
[hyperlink](url for the hyperlink)
Any valid HTML can also be used.
--->
# CSOUND VERSION 6.14 RELEASE NOTES
A number of bug fixes and enhancements, but also potentially
significant changes are included.
For live coders the orchestra macros are now remembered between calls
to compilerstr. This should not change the behaviour of current valid
orchestras but could be useful in live coding.
MIDI devices now include mapping multiple devices to higher channels.
The details are in the manual MIDI section.
-- The Developers
## USER-LEVEL CHANGES
### New opcodes
- randc is like randi but uses a cubic interpolation.
- mp3out is an experimental implementation of writing an mp3 file. It
may be replaced by the current work in libsndfile to deal with MPEG
files. See appendix.
- metro2 is like metro but with added controllable swing.
- ftexists reports whether a numbered ftable exists.
- schedulek is a k-time opcode just like schedule.
- new array based channel opcodes: chngeti, chngetk, chngeta, chngets,
chnseti, chnsetk, chnseta, chnsets.
- lastcycle ientifies the last k-cycle of an instrument instance.
- strstrip removeswhitespace from both ends of a string.
### New Gen and Macros
### Orchestra
- The conditional expression syntax a?b:c incorrectly always
calculated b and c before selecting which to return. This could
give incorrect division by zero errors or cause unexpected multiple
evaluations of opcodes. It now implements the common C-like semantics.
- Orchestra macros are now persistent, so they apply in every
compilation after they are defined until they are undefined. It has
been changed because of the need of live coding in particular. A
correct orchestra should not be affected.
- Following a syntax error there were cases when Csound gave a
segmentation error. This is now fixed.
### Score
-
### Options
- New option simple-sorted-score creates file score.srt in a more
user-friendly format
- Revise treatment of CsOptions wrt double quotes and spaces which need escaping.
- Setting the 1024 bit in -m suppresses printing of messages about
using deprecated opcodes. This option is itself deprecated.
### Modified Opcodes and Gens
- squinewave now handles optional a or k rate argument.
- pindex opcode handles string fields as well as numeric ones.
- sflooper reworked to avoid a crash and provide warnings.
- event_i and schedule can take fractional p1.
- in sound font opcodes better checking. Also no longer will load
multiple copies of a sound font, but reuses existing load.
- fluidControl has a new optional argument to control printing
messages.
- bpf has an audio version now.
- stsend/stecv can work with unmatched k-rates.
- pvstrace has new optional arguments.
- lpfreson checks number of poles.
- syncloop had a small typing error that caused crashes.
- bpfcs has new array versions.
- zacl can omit second argument, defaults to clearing only the given
channel.
- outvalue attempted to use a k-rate value which could be invalid at
the time. This is mainly a small performance problem, and it is now
eliminated.
- Channel names for chnget and chnset opcodes can now be updated at k-rate so
they can be called within a loop.
- copya2ftab now has an optional additional argument which is an
offset into the ftable for where to copy the array.
### Utilities
- lpanal now checks that sufficient poles are requested.
### Frontends
- Belacsound:
- CsoundQt:
Released to coincide with Csound 6.14 there is CsoundQt 0.9.7
See Release notes [https://github.com/CsoundQt/CsoundQt/blob/master/release_notes/Release%20notes%200.9.7.md]
### General Usage
- // comments at the start of a line now accepted in CsOptions
section of a csd file.
- Option --orc has been corrected so it runs without a score; that is for ever until an exit condition.
## Bugs Fixed
- shiftin fixed.
- exitnow delivers the return code as documented.
- fixed bug in beosc, where gaussian noise generator was not being
initialised.
- OSCraw fixed.
- ftkloadk could select incorrect internal code causing a crash.
- GEN01 when used to read a single channel of a multi-channel file got
the length incorrect.
- ftgenonce had a fencepost problem so it could overwrite a table in
use.
- a race condition in Jacko opcodes improved (issue #1182).
- syncloop had a small typing error that caused crashes.
- lowresx was incomplete and did not work as intended; rewritten (issue #1199)
- if outch was incorrectly given an odd number parameters it would give
a segmentation error. This now gives an error message.
# SYSTEM LEVEL CHANGES
-
### System Changes
- New plugin class for opcodes with no outputs written.
perform time errors and init errors are also reported in the return code of
the command line system. The new API function GetErrorCnt is
available to do something similar in other variants.
-
### Translations
### API
- Function GetErrorCnt gives the number of perf-time errors, and adds
in the init-time errors at the end of a rendering.
- Function FTnp2Find no longer prints messages if the table is not
found, but just returns NULL. Previous behaviour is available as
FTnp2Finde.
- csoundGetInstrument() added
### Platform Specific
- WebAudio:
- added csoundCompile to CsoundObj that adds commandline args so that one can
override CsOptions values in CSDs
- added getPlayState(), addPlayStateListener(), and other methods to CsoundObj
for querying and listening to changes of play state
- iOS
- Android
- Windows
- stsend reworked for winsock library
- MacOS
- GNU/Linux
- Haiku port
- Bela
### Appendix: Experimental mp3out
Simple example:
```
<CsoundSynthesizer>
<CsInstruments>
ksmps = 1000
instr 1
aa diskin "fox.wav", 1
mp3out aa,aa,"test.mp3"
endin
</CsInstruments>
<CsScore>
i1 0 3
e
</CsScore>
</CsoundSynthesizer>
```
The syntax is `mp3out aleft,aright, Sfilename` with three optional arguments `mode` (0=stereo, 1=Jointstereo (default), 3=Mono), `bitrate` defaulting to 256, and `quality` (in range 1 to 7) defaulting to 2 (high quality).
==END==
|
