summaryrefslogtreecommitdiff
path: root/opcodes/JackoNoteOut.xml
blob: bc8a0deb0f1a67dea6e0051a929c4344f044cb29 (plain)
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
<refentry id="JackoNoteOut">
  <indexterm id="IndexJackoNoteOut"><primary>JackoNoteOut</primary></indexterm>
  <refentryinfo><title>Jacko Opcodes</title></refentryinfo>
  <refmeta>
    <refentrytitle>JackoNoteOut</refentrytitle>
  </refmeta>
  
  <refnamediv>
    <refname>JackoNoteOut</refname>
    <refpurpose>
      Sends a MIDI channel message to a Jack port.     
    </refpurpose>
  </refnamediv>  
  
  <refsect1>
    <title>Description</title>
    <para>
      Sends a MIDI channel message to a Jack MIDI output port
      inside this instance of Csound, and in turn to its 
      connected external Jack MIDI input port.
    </para>    
  </refsect1>
  
  <refsect1>
    <title>Syntax</title>
    <synopsis><command>JackoNoteOut </command> ScsoundPortName, kstatus, kchannel, kdata1[, kdata2]</synopsis>
  </refsect1>
  
  <refsect1>
    <title>Initialization</title>
    <para>
      <emphasis>ScsoundPortName</emphasis> -- The short name ("portname") 
      of the internal Jack audio output port.
    </para>
  </refsect1>

  <refsect1>
    <title>Performance</title>
    <para> 
      <emphasis>kstatus</emphasis> -- MIDI status byte; must indicate a MIDI channel
      message.
    </para>

    <para> 
      <emphasis>kchannel</emphasis> -- MIDI channel (from 0 through 15).
    </para>
    
    <para> 
      <emphasis>kdata1</emphasis> -- First data byte of a MIDI channel message.
    </para>
    
    <para> 
      <emphasis>kdata2</emphasis> -- Optional second data byte of a MIDI channel message.
    </para>
    
    <para> 
      This opcode can be called any number of times 
      in the same kperiod. Messages from multiple instances 
      of the opcode sending to the same port are collected 
      before sending. 
    </para>
    
    <para> 
      Running status, system exclusive messages, and 
      real-time messages are not supported.
    </para>
    
    <para> 
      The granularity of timing is Csound's kperiod.
    </para>
  </refsect1>
  
  <refsect1>
    <title>See Also</title>
    <para>
      <link linkend="JackoInit"><citetitle>JackoInfo</citetitle></link>, 
      <link linkend="JackoInfo"><citetitle>JackoInfo</citetitle></link>, 
      <link linkend="JackoFreewheel"><citetitle>JackoFreewheel</citetitle></link>, 
      <link linkend="JackoAudioInConnect"><citetitle>JackoAudioInConnect</citetitle></link>, 
      <link linkend="JackoAudioOutConnect"><citetitle>JackoAudioOutConnect</citetitle></link>, 
      <link linkend="JackoMidiInConnect"><citetitle>JackoMidiInConnect</citetitle></link>, 
      <link linkend="JackoMidiOutConnect"><citetitle>JackoMidiOutConnect</citetitle></link>, 
      <link linkend="JackoOn"><citetitle>JackoOn</citetitle></link>, 
      <link linkend="JackoAudioIn"><citetitle>JackoAudioIn</citetitle></link>, 
      <link linkend="JackoMidiOut"><citetitle>JackoMidiOut</citetitle></link>, 
      <link linkend="JackoOpcodes"><citetitle>The Jacko Opcodes</citetitle></link>.
    </para>
  </refsect1>

  <refsect1>
    <title>Credits</title>
    <para>By: &namemichael; 2010</para>
  </refsect1>

</refentry>