csound-flossmanual / csound-floss Goto Github PK

In the score it states:
i 1 0 2 ; line envelope
i 2 2 1; expon envelope

However, comparing a 2 second line envelope to a 1 second expon env is not as illustrative as:
i 1 0 2 ; line envelope
i 2 2 2; expon envelope

Hello,

at this link
https://github.com/csound-flossmanual/csound-floss/blob/develop/book/03-a-initialization-and-performance-pass.md#init-versus-equals

I am not sure , I think there are some mistyped..."1 should be 0" and "perf. cycle should be control cycle".

releated sentence:
kCount = 1 sets the value for kCount to zero again and again, in each performance cycle.

This is not an issue but rather a suggestion.

What would you think of adding a search bar right below previous/next section in the sidebar?
A somewhat low visibility box similar to the dark mode toggle would fit well with the overall design in my opinion.

If it gets implemented, I'd love to focus search bar at the press of / key.
It is standard and allows to navigate content very fast.

And while we're at it, adding keybindings for those previous/next section would complete the set. I don`t know about other keyboard layouts, but with en_US, the bottom-right keys are:

So , . and / keys would translate to < previous, > next and ? search functions.

First of all thank you very much for this incredible interactive manual!

And I'm not sure if this is reason enough to create an "issue" since I'm really nitpicking here. But since I actually learnt the correct spelling in German for "separat" not so long ago, I was a little confused when I read "seperate" and "seperately" here multiple times - thinking that maybe the English spelling was the reason for my German misspelling ... until I checked and found that it's also wrong in English (so I have no more excuses, haha).

There are currently 8 occurences: https://github.com/search?q=repo%3Acsound-flossmanual%2Fcsound-floss+seperate&type=code

In the HTML output for the manual, paragraphs that are separated by spaces in the markdown source are not separated by paragraphs in the compiled book.

In other words,

This is a nice markdown paragraph.

And after a blank line, this is another nice markdown paragraph.

becomes:

This is a nice markdown paragraph.
And after a blank line, this is another nice markdown paragraph.

I am not using Docker. I am using Ubuntu 18.04 with Python 3.6.8. I installed all requirements and installed Pandoc 2.8.1 from the current Debian package.

mkg@bodhimandala:~/csound-floss$ python3 build.py html
-- combined_metadata
.  html
/usr/bin/pandoc -f markdown+line_blocks+escaped_line_breaks+smart+fenced_code_blocks+fenced_code_attributes+backtick_code_blocks+yaml_metadata_block+implicit_figures+tex_math_dollars+implicit_figures+link_attributes +RTS -K4096m -RTS -F scripts/pandoc-filter.py --standalone --mathjax  -t html --css=resources/styles/fonts.css --css=resources/styles/html.css -H resources/html/head_include.html -B resources/html/body_include.html -o csound-floss-export.html tmp/preprocessed/metadata.yaml tmp/preprocessed/00--aa-toc.md tmp/preprocessed/00-a-preface.md tmp/preprocessed/00-b-how-to-use-this-manual.md tmp/preprocessed/00-c-on-this-release.md tmp/preprocessed/00-d-credits.md tmp/preprocessed/01-a-digital-audio.md tmp/preprocessed/01-b-pitch-and-frequency.md tmp/preprocessed/01-c-intensities.md tmp/preprocessed/01-d-random.md tmp/preprocessed/02-a-make-csound-run.md tmp/preprocessed/02-b-csound-syntax.md tmp/preprocessed/02-c-configuring-midi.md tmp/preprocessed/02-d-live-audio.md tmp/preprocessed/02-e-rendering-to-file.md tmp/preprocessed/03-a-initialization-and-performance-pass.md tmp/preprocessed/03-b-local-and-global-variables.md tmp/preprocessed/03-c-control-structures.md tmp/preprocessed/03-d-function-tables.md tmp/preprocessed/03-e-arrays.md tmp/preprocessed/03-f-live-events.md tmp/preprocessed/03-g-user-defined-opcodes.md tmp/preprocessed/03-h-macros.md tmp/preprocessed/03-i-functional-syntax.md tmp/preprocessed/04-a-additive-synthesis.md tmp/preprocessed/04-b-subtractive-synthesis.md tmp/preprocessed/04-c-amplitude-and-ring-modulation.md tmp/preprocessed/04-d-frequency-modulation.md tmp/preprocessed/04-e-waveshaping.md tmp/preprocessed/04-f-granular-synthesis.md tmp/preprocessed/04-g-physical-modelling.md tmp/preprocessed/04-h-scanned-synthesis.md tmp/preprocessed/05-a-envelopes.md tmp/preprocessed/05-b-panning-and-spatialization.md tmp/preprocessed/05-c-filters.md tmp/preprocessed/05-d-delay-and-feedback.md tmp/preprocessed/05-e-reverberation.md tmp/preprocessed/05-f-am-rm-waveshaping.md tmp/preprocessed/05-g-granular-synthesis.md tmp/preprocessed/05-h-convolution.md tmp/preprocessed/05-i-fourier-analysis-spectral-processing.md tmp/preprocessed/05-k-ats-resynthesis.md tmp/preprocessed/05-l-amplitude-and-pitch-tracking.md tmp/preprocessed/06-a-record-and-play-soundfiles.md tmp/preprocessed/06-b-record-and-play-buffers.md tmp/preprocessed/07-a-receiving-events-by-midiin.md tmp/preprocessed/07-b-triggering-instrument-instances.md tmp/preprocessed/07-c-working-with-controllers.md tmp/preprocessed/07-d-reading-midi-files.md tmp/preprocessed/07-e-midi-output.md tmp/preprocessed/08-a-open-sound-control.md tmp/preprocessed/08-b-csound-and-arduino.md tmp/preprocessed/09-a-csound-in-pd.md tmp/preprocessed/09-b-csound-in-maxmsp.md tmp/preprocessed/09-c-csound-as-a-vst-plugin.md tmp/preprocessed/10-a-csoundqt.md tmp/preprocessed/10-b-cabbage.md tmp/preprocessed/10-c-blue.md tmp/preprocessed/10-d-winxound.md tmp/preprocessed/10-e-csound-via-terminal.md tmp/preprocessed/10-f-web-based-csound.md tmp/preprocessed/11-a-analysis.md tmp/preprocessed/11-b-file-info-and-conversion.md tmp/preprocessed/11-c-miscellaneous.md tmp/preprocessed/12-a-the-csound-api.md tmp/preprocessed/12-b-python-and-csound.md tmp/preprocessed/12-c-lua-in-csound.md tmp/preprocessed/12-d-csound-in-ios.md tmp/preprocessed/12-e-csound-on-android.md tmp/preprocessed/12-f-csound-and-haskell.md tmp/preprocessed/12-g-csound-and-html.md tmp/preprocessed/13-a-developing-plugin-opcodes.md tmp/preprocessed/14-a-methods-of-writing-csound-scores.md tmp/preprocessed/14-b-python-in-csoundqt.md tmp/preprocessed/15-a-opcode-guide.md tmp/preprocessed/15-b-glossary.md tmp/preprocessed/15-c-links.md 
[WARNING] Duplicate note reference '1' at line 3367 column 1
[WARNING] Duplicate note reference '1' at line 3905 column 1
[WARNING] Duplicate note reference '2' at line 3907 column 1
[WARNING] Duplicate note reference '1' at line 4314 column 1
[WARNING] Duplicate note reference '2' at line 4315 column 1
[WARNING] Duplicate note reference '3' at line 4328 column 1
[WARNING] Duplicate note reference '1' at line 4471 column 1
[WARNING] Duplicate note reference '1' at line 6153 column 1
[WARNING] Duplicate note reference '2' at line 6156 column 1
[WARNING] Duplicate note reference '3' at line 6159 column 1
[WARNING] Duplicate note reference '4' at line 6160 column 1
[WARNING] Duplicate note reference '5' at line 6164 column 1
[WARNING] Duplicate note reference '6' at line 6168 column 1
[WARNING] Duplicate note reference '1' at line 8381 column 1
[WARNING] Duplicate note reference '2' at line 8384 column 1
[WARNING] Duplicate note reference '3' at line 8386 column 1
[WARNING] Duplicate note reference '1' at line 8488 column 1
[WARNING] Duplicate note reference '2' at line 8535 column 1
[WARNING] Duplicate note reference '3' at line 9085 column 1
[WARNING] Duplicate note reference '1' at line 9729 column 1
[WARNING] Duplicate note reference '3' at line 10141 column 1
[WARNING] Duplicate note reference '4' at line 10565 column 1
[WARNING] Duplicate note reference '1' at line 12361 column 1
[WARNING] Duplicate note reference '2' at line 12423 column 1
[WARNING] Duplicate note reference '3' at line 12487 column 1
[WARNING] Duplicate note reference '1' at line 13545 column 1
[WARNING] Duplicate note reference '1' at line 14166 column 1
[WARNING] Duplicate note reference '2' at line 14262 column 1
[WARNING] Duplicate note reference '3' at line 14296 column 1
[WARNING] Duplicate note reference '4' at line 14339 column 1
[WARNING] Duplicate note reference '1' at line 15722 column 1
[WARNING] Duplicate note reference '1' at line 16143 column 1
[WARNING] Duplicate note reference '2' at line 16236 column 1
[WARNING] Duplicate note reference '3' at line 16243 column 1
[WARNING] Duplicate note reference '1' at line 17925 column 1
[WARNING] Duplicate note reference '2' at line 17962 column 1
[WARNING] Duplicate note reference '1' at line 20202 column 1
[WARNING] Duplicate note reference '2' at line 20254 column 1
[WARNING] Duplicate note reference '1' at line 20798 column 1
[WARNING] Duplicate link reference '[2]' at line 21138 column 1
[WARNING] Duplicate note reference '3' at line 21373 column 1
[WARNING] Duplicate note reference '4' at line 21441 column 1
[WARNING] Duplicate note reference '5' at line 21527 column 1
[WARNING] Duplicate note reference '1' at line 24258 column 1
[WARNING] Duplicate note reference '1' at line 25387 column 1
[WARNING] Duplicate note reference '2' at line 25396 column 1
[WARNING] Duplicate note reference '3' at line 25410 column 1
[WARNING] Duplicate note reference '4' at line 25430 column 1
[WARNING] Duplicate note reference '5' at line 25439 column 1
[WARNING] Duplicate note reference '6' at line 25493 column 1
[WARNING] Duplicate note reference '7' at line 25581 column 1
[WARNING] Duplicate note reference '1' at line 25982 column 1
[WARNING] Duplicate note reference '2' at line 25984 column 1
[WARNING] Duplicate note reference '3' at line 25988 column 1
[WARNING] Duplicate note reference '4' at line 26003 column 1
[WARNING] Duplicate note reference '5' at line 26254 column 1
[WARNING] Duplicate note reference '6' at line 26256 column 1
[WARNING] Duplicate note reference '1' at line 27691 column 1
[WARNING] Duplicate note reference '2' at line 27773 column 1
[WARNING] Duplicate note reference '1' at line 28199 column 1
[WARNING] Duplicate note reference '2' at line 28226 column 1
[WARNING] Duplicate note reference '1' at line 29583 column 1
[WARNING] Duplicate note reference '1' at line 31239 column 1
[WARNING] Duplicate note reference '1' at line 32510 column 1
[WARNING] Duplicate note reference '1' at line 33526 column 1
[WARNING] Duplicate note reference '2' at line 33552 column 1
[WARNING] Duplicate note reference '1' at line 36276 column 1
  File "scripts/pandoc-filter.py", line 103
    def __init__(self, value: Optional[T] = None):

on a clean debian 10 build, i created a venv and had two problems:

1. during pip install -r requirements.txt there is one error message:
   Building wheels for collected packages: pyinotify
   Running setup.py bdist_wheel for pyinotify ... error
   Complete output from command /home/jh/src/csound-floss/python-env/bin/python3 -u -c "import setuptools, tokenize;file='/tmp/pip-install-kk5h3zp_/pyinotify/setup.py';f=getattr(tokenize, 'open', open)(file);code=f.read().replace('\r\n', '\n');f.close();exec(compile(code, file, 'exec'))" bdist_wheel -d /tmp/pip-wheel-nhntxr43 --python-tag cp37:
   usage: -c [global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...]
   or: -c --help [cmd1 cmd2 ...]
   or: -c --help-commands
   or: -c cmd --help

error: invalid command 'bdist_wheel'

Failed building wheel for pyinotify
Running setup.py clean for pyinotify
Failed to build pyinotify

2. the pip command finished nevertheless, but afterwards pandoc could not be found:
   Installing collected packages: PyYAML, grizzled-python, cloudpickle, pyinotify, doit, click, future, shutilwhich, panflute, webencodings, tinycss2, cssselect2, defusedxml, pycparser, cffi, cairocffi, pillow, CairoSVG, Pyphen, six, html5lib, WeasyPrint, tornado, livereload
   Running setup.py install for pyinotify ... done
   Successfully installed CairoSVG-2.4.2 PyYAML-5.1.2 Pyphen-0.9.5 WeasyPrint-50 cairocffi-1.1.0 cffi-1.13.2 click-7.0 cloudpickle-1.2.2 cssselect2-0.2.2 defusedxml-0.6.0 doit-0.31.1 future-0.18.2 grizzled-python-2.2.0 html5lib-1.0.1 livereload-2.6.1 panflute-1.11.2 pillow-6.2.1 pycparser-2.19 pyinotify-0.9.6 shutilwhich-1.1.0 six-1.13.0 tinycss2-1.0.2 tornado-6.0.3 webencodings-0.5.1
   (python-env) jh@lenovdeb10:~/src/csound-floss$ python3 build.py html
   Traceback (most recent call last):
   File "build.py", line 130, in
   PANDOC = find_in_path("pandoc")
   File "/home/jh/src/csound-floss/lib/init.py", line 364, in find_in_path
   raise OSError(f"""Can't find "{command}" in PATH.""")
   OSError: Can't find "pandoc" in PATH.

Hi!

I'm currently in the process of learning csound and decided for the .epub version; now, I noticed that the LaTeX (?) equations are not rendered properly:

Had to resort for the online / PDF version (which wasn't a problem)...

Thank you very much for this manual :-)

i followed the description and built all dependencies with
pip install -r requirements.txt

but plantuml is not being found. i added it to PATH which seems to work ...

(base) fmsbw19s-Mac-Pro:~ fmsbw19$ plantuml.py
-bash: /Users/fmsbw19/anaconda3/lib/python3.7/site-packages/plantuml.py: Permission denied

... but it does not help:
(base) fmsbw19s-Mac-Pro:csound-floss fmsbw19$ python3 build.py html
-- combined_metadata
. html
/Users/fmsbw19/anaconda3/bin/pandoc -f markdown+line_blocks+escaped_line_breaks+smart+fenced_code_blocks+fenced_code_attributes+backtick_code_blocks+yaml_metadata_block+implicit_figures+tex_math_dollars+implicit_figures+link_attributes +RTS -K4096m -RTS -F scripts/pandoc-filter.py -F scripts/plantuml-filter.py --standalone --mathjax -t html --css=resources/styles/fonts.css --css=resources/styles/html.css -H resources/html/head_include.html -B resources/html/body_include.html -o csound-floss-export.html tmp/preprocessed/metadata.yaml tmp/preprocessed/00--aa-toc.md tmp/preprocessed/00-a-preface.md tmp/preprocessed
etc ...
[WARNING] Duplicate note reference '1' at line 3414 column 1
etc ...
[WARNING] Duplicate identifier 'introduction' at line 34346 column 1
Traceback (most recent call last):
File "scripts/plantuml-filter.py", line 24, in
COMMAND = find_in_path("plantuml")
File "/Users/fmsbw19/src/csound-floss/lib/init.py", line 364, in find_in_path
raise OSError(f"""Can't find "{command}" in PATH.""")
OSError: Can't find "plantuml" in PATH.
Error running filter scripts/plantuml-filter.py:
fd:13: hPutBuf: resource vanished (Broken pipe)

None of the examples that contain printks show properly in the Messages tab of Csound for Android. I don't know if this is Android specific or not, if so I can open the appropriate ticket.

However, adding the following:

-odac

allows them to show properly.

Sorry for the influx of posts but I'm only a few weeks into learning Csound with no programming experience, and although initially overwhelmed I'm starting to get a grasp on things. The manual is very informative, however seems very hit or miss and strangely jumping between rudimentary to advanced elements and back.

I think many newcomers may find this a little frustrating, for example jumping into somewhat complex randomization in chapter 1 before even introducing an oscillator in chapter 2. Really? And then not delving into envelopes until chapter 5 when chapter 2 goes straight from introducing an oscillator to then setting up external midi instruments? That's a good way to alienate non-academics.

at https://flossmanual.csound.com/
below the other download buttons

As a newbie reading the manual, it would be helpful to add another linsegr to chapter 5 that didn't involve live midi input. Writing scores I discovered it is very useful for overlapping pads and note sequences, in fact it is confusingly used at the very beginning of the manual, long before most new to Csound would understand the opcodes, in example 01A13 (which I really like) .

A very simple ex . would be something like:


-odac -m0


sr = 44100
ksmps = 32
nchnls = 2
0dbfs = 1

instr 1
icps = p4
; attack-|sustain-|-release
aEnv linsegr 0, 0.001, 0.5, p3, 0.5, 0.5, 0; envelope that senses note releases
aSig poscil aEnv, icps ; audio oscillator
out aSig, aSig ; audio sent to output
endin

P.S. the option -M0 from the FLOSS manual crashes Csound Android when I attempt to play the file, -m0 does not.

I see "FLOSS" in the name but cannot locate a COPYING or LICENSE file, nor do I see anything related to Creative Commons. Under what terms may I use this work?

I often take notes alongside documentation and, aside from understanding how any contribututions may be used by others, I would like to know if I could publish separately should my writings significantly diverge or otherwise be unfit for merging (e.g. different format, etc.).

Regardless, thank you for creating, sharing, and maintaining this excellent resource.

Hi again, I just started studying arrays. I think this example needs to be updated as the array opcode is deprecated and I received an error message so it would not run. It appears to be a matter of changing opcode array to fillarray.

Ex. from manual ver 7.0.1
instr 1
iArr[] array 1, 2, 3
IArr[0] = iArr[0] + 10
prints " iArr[0] = %d\n\n", iArr[0]
endin

After reading Canonical I modified to:

instr 1
iArr[] fillarray 1, 2, 3
iArr[0] = iArr[0] + 10
prints " iArr[0] = %d\n\n", iArr[0]
endin

instr 2
kArr[] fillarray 1, 2, 3
kArr[0] = kArr[0] + 10
printks " kArr[0] = %d\n", 0, kArr[0]
endin

This worked for me with no error mssg.

As suggested at the start of the manual, it's a good idea to type these examples out by hand to form some sort of muscle memory. I'm a total novice at csound, but the manual is gentle!

this example 03F03_Score_Tricks.csd in the pdf contains a bug ( looks like a escaping issues with %% and \[ , \]

it should look like this

but the pdf shows it as

A PR/patch for it

#50

this happens from csoundQT but also if i send this csd to csound via the SublimeText editor plugin, so i think something is up with the script?

https://github.com/csound-flossmanual/csound-floss/blob/master/book/05-c-filters.md#filter-comparision

On my machine if i want to dump all these variations to disk, according to the example's comment in the score i would have to change

<CsScore>
; the fourth parameter is a reverb mix level
i "PlayAll" 0 1 0.35
; uncomment to save output to wav files
; i "DumpAll" 0 1 0.35
</CsScore>

and uncomment the DumpAll, and maybe comment the PlayAll if i don't need to hear it while it's dumping..

<CsScore>
; the fourth parameter is a reverb mix level
; i "PlayAll" 0 1 0.35
; uncomment to save output to wav files
i "DumpAll" 0 1 0.35
</CsScore>

but then only the first wav is generated "moogladder-dubstep.wav".
moogladder-dubstep_DUMP.zip