summaryrefslogtreecommitdiff
path: root/opcodes/insglobal.xml
blob: c8929ae89eddd4c3d107792b0a60a5c1fd475d08 (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
<refentry id="insglobal">
<indexterm id="Indexinsglobal"><primary>insglobal</primary></indexterm>
  <refentryinfo><title>Remote Opcodes</title></refentryinfo>
  <refmeta>
    <refentrytitle>insglobal</refentrytitle>
  </refmeta>

  <refnamediv>
    <refname>insglobal</refname>
    <refpurpose>
      An opcode which can be used to implement a remote orchestra. This opcode will send note events from a source machine to many destinations.
          </refpurpose>
  </refnamediv>

  <refsect1>
    <title>Description</title>
    <para>
      With the <link linkend="insremot"><citetitle>insremot</citetitle></link> and <emphasis>insglobal</emphasis> opcodes you are able to perform instruments on remote machines and control them from a master machine. The remote opcodes are implemented using the master/client model. All the machines involved contain the same orchestra but only the master machine contains the information of the score. During the performance the master machine sends the note events to the clients. The <emphasis>insglobal</emphasis> opcode sends the events to all the machines involved in the remote concert. These machines are determined by the <link linkend="insremot"><citetitle>insremot</citetitle></link> definitions made above the <emphasis>insglobal</emphasis> command. To send events to only one machine use <link linkend="insremot"><citetitle>insremot</citetitle></link>.
    </para>
  </refsect1>

  <refsect1>
    <title>Syntax</title>
    <synopsis><command>insglobal</command>isource, instrnum [,instrnum...] </synopsis>
  </refsect1>

  <refsect1>
    <title>Initialization</title>    
    <para>
      <emphasis>isource</emphasis>
      -- a string that is the intended host computer (e.g. 192.168.0.100). This is the source host which generates the events of the given instrument(s) and sends it to all the machines involved in the remote concert.
    </para>

    <para>
      <emphasis>instrnum</emphasis>
      -- a list of instrument numbers which will be played on the destination machines
    </para>

  </refsect1>

<!--  <refsect1>
    <title>Performance</title>
    
  </refsect1>-->
  <refsect1>
    <title>Examples</title>
    <para>
      See the entry for <link linkend="insremot"><citetitle>insremot</citetitle></link> for an example of usage.
    </para>
  </refsect1>

  <refsect1>
    <title>See also</title>
    <para>
      <link linkend="insremot"><citetitle>insremot</citetitle></link>, <link linkend="midglobal"><citetitle>midglobal</citetitle></link>, <link linkend="midremot"><citetitle>midremot</citetitle></link>
    </para>
  </refsect1>

  <refsect1>
    <title>Credits</title>
    <para>
      <simplelist>
        <member>Author: Simon Schampijer</member>
        <member>2006</member>
      </simplelist>
    </para>
    <para>
      New in version 5.03
    </para>
  </refsect1>
</refentry>