From 20cfc796bae5e50e9467557746dc9546a8740231 Mon Sep 17 00:00:00 2001 From: Menno Knevel Date: Fri, 10 Nov 2023 17:24:23 +0100 Subject: [PATCH 1/4] removed deprecated JackoOn --- examples/JackoAudioIn.csd | 1 - examples/JackoAudioOut.csd | 1 - examples/JackoFreewheel.csd | 1 - examples/JackoMidiInConnect.csd | 1 - examples/JackoMidiOut.csd | 1 - examples/JackoNoteOut.csd | 1 - examples/JackoTransport.csd | 3 +-- examples/jacko_extSynths.csd | 4 +--- 8 files changed, 2 insertions(+), 11 deletions(-) diff --git a/examples/JackoAudioIn.csd b/examples/JackoAudioIn.csd index 3851fbd3f9..7f47aa8268 100644 --- a/examples/JackoAudioIn.csd +++ b/examples/JackoAudioIn.csd @@ -17,7 +17,6 @@ nchnls = 2 JackoInit "default", "csound" JackoAudioInConnect "system:capture_1", "audioin" ; create 1 Audio input & connect from soundcard -JackoOn instr 1 ; use Csound as an effect processor asig JackoAudioIn "audioin" diff --git a/examples/JackoAudioOut.csd b/examples/JackoAudioOut.csd index 13e46c99d0..69929f29e8 100644 --- a/examples/JackoAudioOut.csd +++ b/examples/JackoAudioOut.csd @@ -17,7 +17,6 @@ nchnls = 2 JackoInit "default", "csound" JackoAudioOutConnect "audioout", "system:playback_4" ; create 1 Audio output & connect to soundcard -JackoOn instr 1 asig vco2 .2, 100 diff --git a/examples/JackoFreewheel.csd b/examples/JackoFreewheel.csd index 553a6ab10a..064dd972e7 100644 --- a/examples/JackoFreewheel.csd +++ b/examples/JackoFreewheel.csd @@ -25,7 +25,6 @@ JackoAudioOutConnect "rightout", "system:playback_2" JackoInfo JackoFreewheel 1 ; Turning freewheeling on seems automatically to turn system playback off. This is good! -JackoOn alwayson "jackin" diff --git a/examples/JackoMidiInConnect.csd b/examples/JackoMidiInConnect.csd index 38d6024529..f57c24ed7e 100644 --- a/examples/JackoMidiInConnect.csd +++ b/examples/JackoMidiInConnect.csd @@ -14,7 +14,6 @@ nchnls = 2 JackoInit "default", "csound6" ; Csound as a Jack client JackoMidiInConnect "UM-3:midi/playback_2", "midiinEDIROL" ; create 1 Midi in port -JackoOn instr 1 ; get notes to the EDIROL Midi port ifreq cpsmidi diff --git a/examples/JackoMidiOut.csd b/examples/JackoMidiOut.csd index a159005e1d..e658b4d760 100644 --- a/examples/JackoMidiOut.csd +++ b/examples/JackoMidiOut.csd @@ -14,7 +14,6 @@ nchnls = 2 JackoInit "default", "csound6" ; Csound as a Jack client JackoMidiOutConnect "midioutMAUDIO", "M-Audio-Delta-1010:midi/capture_1" -JackoOn ; turn Jacko system on instr 1 diff --git a/examples/JackoNoteOut.csd b/examples/JackoNoteOut.csd index 6d21df7405..641949e0a7 100644 --- a/examples/JackoNoteOut.csd +++ b/examples/JackoNoteOut.csd @@ -13,7 +13,6 @@ nchnls = 2 JackoInit "default", "csound6" ; Csound as a Jack client JackoMidiOutConnect "midioutMAUDIO", "M-Audio-Delta-1010:midi/capture_1" ; create 1 Midi port JackoMidiOutConnect "midioutEDIROL", "UM-3:midi/capture_1" ; create 2nd Midi port -JackoOn instr 1 ; send notes to the M-Audio Midi port diff --git a/examples/JackoTransport.csd b/examples/JackoTransport.csd index 447a4cdc61..2496c10683 100644 --- a/examples/JackoTransport.csd +++ b/examples/JackoTransport.csd @@ -1,6 +1,6 @@ -;-+rtaudio=JACK -o dac:system:playback_ +-n sr = 48000 @@ -11,7 +11,6 @@ nchnls = 2 ; by Menno Knevel - 2023 JackoInit "default", "csound6" ; Csound as a Jack client -JackoOn ; activate the Jacko system instr 1 ; position & start external DAW JackoTransport 3, 10 ; set playbackhead of DAW to zero in 10 seconds diff --git a/examples/jacko_extSynths.csd b/examples/jacko_extSynths.csd index f632e427e6..a8e2dac285 100644 --- a/examples/jacko_extSynths.csd +++ b/examples/jacko_extSynths.csd @@ -1,6 +1,6 @@ --+rtaudio=jack -o dac -+rtmidi=null -Ma; +-o dac -+rtmidi=null -Ma; @@ -15,8 +15,6 @@ JackoInit "default", "csound6" ; Csound as a Jack client JackoMidiInConnect "UM-3:midi/playback_2", "midiinEDIROL" ; create 1 Midi in port JackoMidiOutConnect "midioutMAUDIO", "M-Audio-Delta-1010:midi/capture_1" ; create 1 Midi output port JackoMidiOutConnect "midioutEDIROL", "UM-3:midi/capture_1" ; create 2nd Midi output port -JackoOn - instr 1 ; get notes from score AND from the EDIROL Midi port "midiinEDIROL" From cde9bf1190a9e78a65abc354bb06ae45416c5810 Mon Sep 17 00:00:00 2001 From: Menno Knevel Date: Fri, 10 Nov 2023 17:25:16 +0100 Subject: [PATCH 2/4] added PortMidi info --- overview/realtimelinux.xml | 24 ++++++++++-------------- overview/realtimemac.xml | 8 +++++++- overview/realtimewindows.xml | 10 ++++++++-- overview/using.xml | 2 +- 4 files changed, 26 insertions(+), 18 deletions(-) diff --git a/overview/realtimelinux.xml b/overview/realtimelinux.xml index d6608d87d5..5af266b668 100644 --- a/overview/realtimelinux.xml +++ b/overview/realtimelinux.xml @@ -10,15 +10,15 @@ similar but fundamentally different from that provided by JACK. - Scheduling - If you are able to run Csound as the root user, using the "--sched" + If you are able to run Csound as the root user, using the "--sched" flag will dramatically improve realtime performance, when using ALSA, however you may hang your system if you do something stupid. DO NOT use "--sched" if you are using JACK for audio output. JACK controls scheduling for the audio applications connected to it, and also tries to run at the highest possible priority. If the "--sched" flag is used, Csound and JACK will be competing rather than cooperating, - resulting in extremely poor performance. + resulting in extremely poor performance. + Using ALSA @@ -27,6 +27,7 @@ flag. Using --sched requires that Csound be run as the root user, which may be impossible or undesirable in some circumstances. + The ALSA plugins require the "name" of a "card" and a "device". Unless you have named your "cards" in ~/.asoundrc (or /etc/asound.conf), the @@ -196,18 +197,13 @@ pcm.!default { MIDI - 2 Midi drivers are available: - - - Raw Midi. - - - - - Alsa Sequencer (since version 5.18). - - + 3 Midi drivers are available: PortMidi, Raw Midi and Alsa Sequencer (since version 5.18). + Csound will use PortMidi as the default MIDI module. With PortMIDI, DEVICE is either a number for single port input, 'a' for listening to all input ports, or 'm' for mapping ports to MIDI channels above 16. In this case, device 0 uses 1-16, device 1 uses 17-32, ... device N uses (N+1)*channel. The options 'a' and 'm' are also convenient when you don't have devices as they will not generate an error. + + + -+rtmidi=PortMIDI -Ma -Q 1 + MIDI Input (Raw Midi driver) In order to enable your orchestra to receive MIDI input you can use VirMIDI or MIDIThru, whichever you prefer. Setting up these virtual MIDI ports is a topic that has been covered extensively diff --git a/overview/realtimemac.xml b/overview/realtimemac.xml index 3da8e2efc2..acc1c7ff44 100644 --- a/overview/realtimemac.xml +++ b/overview/realtimemac.xml @@ -41,7 +41,13 @@ To enable Real-time MIDI on OSX, you can use the -M flag for MIDI input and the -Q flag for MIDI output. You might need to specify the device number after the flag (e.g. -M2), and again, you can find the available devices by giving an out of range number. - Csound will use PortMidi as the default MIDI module, but there's also a native coremidi module, which can be activated with the flag: + Csound will use PortMidi as the default MIDI module. With PortMIDI, DEVICE is either a number for single port input, 'a' for listening to all input ports, or 'm' for mapping ports to MIDI channels above 16. In this case, device 0 uses 1-16, device 1 uses 17-32, ... device N uses (N+1)*channel. The options 'a' and 'm' are also convenient when you don't have devices as they will not generate an error. + + + -+rtmidi=PortMIDI -Ma -Q 1 + + +There's also a native coremidi module, which can be activated with the flag: -+rtmidi=cmidi diff --git a/overview/realtimewindows.xml b/overview/realtimewindows.xml index 1f43f79836..028770d208 100644 --- a/overview/realtimewindows.xml +++ b/overview/realtimewindows.xml @@ -19,7 +19,13 @@ To enable Real-time MIDI on Windows, you can use the -M flag for MIDI input and the -Q flag for MIDI output. You might need to specify the device number after the flag (e.g. -M2), and again, you can find the available devices by giving an out of range number. - Csound will use PortMidi as the default MIDI module, but there's also a native winmme module, which can be activated with the flag: + Csound will use PortMidi as the default MIDI module. With PortMIDI, DEVICE is either a number for single port input, 'a' for listening to all input ports, or 'm' for mapping ports to MIDI channels above 16. In this case, device 0 uses 1-16, device 1 uses 17-32, ... device N uses (N+1)*channel. The options 'a' and 'm' are also convenient when you don't have devices as they will not generate an error. + + + -+rtmidi=PortMIDI -Ma -Q 1 + + + There's also a native winmme module, which can be activated with the flag: -+rtmidi=winmme @@ -31,4 +37,4 @@ -+rtmidi=winmme -M1 -Q1 -+rtaudio=portaudio -odac3 -iadc3 - \ No newline at end of file + diff --git a/overview/using.xml b/overview/using.xml index 3607cebb84..bc7a3af196 100644 --- a/overview/using.xml +++ b/overview/using.xml @@ -159,7 +159,7 @@ B 0.000 .. 2.000 T 2.000 TT 2.000 M: 10000.0 10000.0 only use powers of two for ksmps. - Some settings differ according to platform. See further below for information for each platform. + Some settings differ according to platform. See next pages for information for each platform.
From 01b770fbd989a86fb764d3794477df1dd0066c31 Mon Sep 17 00:00:00 2001 From: Menno Knevel Date: Fri, 10 Nov 2023 17:26:12 +0100 Subject: [PATCH 3/4] added note about running Jack daemon --- opcodes/JackoAudioIn.xml | 4 +++- opcodes/JackoAudioInConnect.xml | 2 ++ opcodes/JackoAudioOut.xml | 2 ++ opcodes/JackoAudioOutConnect.xml | 4 +++- opcodes/JackoFreewheel.xml | 4 +++- opcodes/JackoInfo.xml | 2 ++ opcodes/JackoInit.xml | 2 ++ opcodes/JackoMidiInConnect.xml | 4 +++- opcodes/JackoMidiOut.xml | 4 +++- opcodes/JackoNoteOut.xml | 2 ++ opcodes/JackoTransport.xml | 4 +++- 11 files changed, 28 insertions(+), 6 deletions(-) diff --git a/opcodes/JackoAudioIn.xml b/opcodes/JackoAudioIn.xml index d6d31b4cd4..9a1d16218d 100644 --- a/opcodes/JackoAudioIn.xml +++ b/opcodes/JackoAudioIn.xml @@ -45,7 +45,9 @@ output port to which ScsoundPortName is connected. - + + works with an already running Jack daemon. Do not use -+rtaudio=jack in CsOptions + Examples diff --git a/opcodes/JackoAudioInConnect.xml b/opcodes/JackoAudioInConnect.xml index 8c57d177b8..d2284da992 100644 --- a/opcodes/JackoAudioInConnect.xml +++ b/opcodes/JackoAudioInConnect.xml @@ -49,6 +49,8 @@ + works with an already running Jack daemon. Do not use -+rtaudio=jack in CsOptions + Examples diff --git a/opcodes/JackoAudioOut.xml b/opcodes/JackoAudioOut.xml index 58b319ac37..b868359eff 100644 --- a/opcodes/JackoAudioOut.xml +++ b/opcodes/JackoAudioOut.xml @@ -57,6 +57,8 @@ + works with an already running Jack daemon. Do not use -+rtaudio=jack in CsOptions + Examples diff --git a/opcodes/JackoAudioOutConnect.xml b/opcodes/JackoAudioOutConnect.xml index e02277ca32..0e2b4b84c9 100644 --- a/opcodes/JackoAudioOutConnect.xml +++ b/opcodes/JackoAudioOutConnect.xml @@ -49,7 +49,9 @@ opcode. - + + works with an already running Jack daemon. Do not use -+rtaudio=jack in CsOptions + Examples diff --git a/opcodes/JackoFreewheel.xml b/opcodes/JackoFreewheel.xml index 026e76d267..f9aeb4bae8 100644 --- a/opcodes/JackoFreewheel.xml +++ b/opcodes/JackoFreewheel.xml @@ -45,7 +45,9 @@ ienabled -- Turns freewheeling on (the default) or off. - + + works with an already running Jack daemon. Do not use -+rtaudio=jack in CsOptions + Examples diff --git a/opcodes/JackoInfo.xml b/opcodes/JackoInfo.xml index e28ee18cc5..59e4ccc19c 100644 --- a/opcodes/JackoInfo.xml +++ b/opcodes/JackoInfo.xml @@ -39,6 +39,8 @@ + works with an already running Jack daemon. Do not use -+rtaudio=jack in CsOptions + Examples diff --git a/opcodes/JackoInit.xml b/opcodes/JackoInit.xml index d196d26308..3bc02e8e14 100644 --- a/opcodes/JackoInit.xml +++ b/opcodes/JackoInit.xml @@ -86,6 +86,8 @@ + works with an already running Jack daemon. Do not use -+rtaudio=jack in CsOptions + Examples diff --git a/opcodes/JackoMidiInConnect.xml b/opcodes/JackoMidiInConnect.xml index b36de47353..daa9cb9273 100644 --- a/opcodes/JackoMidiInConnect.xml +++ b/opcodes/JackoMidiInConnect.xml @@ -69,7 +69,9 @@ The granularity of timing is Csound's kperiod. - + + works with an already running Jack daemon. Do not use -+rtaudio=jack in CsOptions + Examples diff --git a/opcodes/JackoMidiOut.xml b/opcodes/JackoMidiOut.xml index 893d72ae3d..bb0f3d6ba4 100644 --- a/opcodes/JackoMidiOut.xml +++ b/opcodes/JackoMidiOut.xml @@ -72,7 +72,9 @@ The granularity of timing is Csound's kperiod. - + + works with an already running Jack daemon. Do not use -+rtaudio=jack in CsOptions + Examples diff --git a/opcodes/JackoNoteOut.xml b/opcodes/JackoNoteOut.xml index 699f673245..7e28b544a7 100644 --- a/opcodes/JackoNoteOut.xml +++ b/opcodes/JackoNoteOut.xml @@ -69,6 +69,8 @@ + works with an already running Jack daemon. Do not use -+rtaudio=jack in CsOptions + Examples diff --git a/opcodes/JackoTransport.xml b/opcodes/JackoTransport.xml index b689618b6f..bcb201bb28 100644 --- a/opcodes/JackoTransport.xml +++ b/opcodes/JackoTransport.xml @@ -52,7 +52,9 @@ The granularity of timing is Csound's kperiod. - + + works with an already running Jack daemon. Do not use -+rtaudio=jack in CsOptions + Examples From d11de51f258d5153a92a433f0fe324d31eb37bdb Mon Sep 17 00:00:00 2001 From: Menno Knevel Date: Fri, 10 Nov 2023 18:01:06 +0100 Subject: [PATCH 4/4] Update JackoMidiOutConnect.xml --- opcodes/JackoMidiOutConnect.xml | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/opcodes/JackoMidiOutConnect.xml b/opcodes/JackoMidiOutConnect.xml index 2463eeb22b..4850608caa 100644 --- a/opcodes/JackoMidiOutConnect.xml +++ b/opcodes/JackoMidiOutConnect.xml @@ -49,7 +49,9 @@ or JackoNoteOut opcodes. - + + works with an already running Jack daemon. Do not use -+rtaudio=jack in CsOptions + Examples