<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>OSC and Network</title>
<link rel="stylesheet" type="text/css" href="csound.css" />
<link rel="stylesheet" type="text/css" href="syntax-highlighting.css" />
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot" />
<link rel="home" href="index.html" title="The Canonical Csound Reference Manual" />
<link rel="up" href="PartOpcodesOverview.html" title="Part II. Opcodes Overview" />
<link rel="prev" href="vst4cs.html" title="VST for Csound" />
<link rel="next" href="OSC.html" title="OSC" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">OSC and Network</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="vst4cs.html">Prev</a> </td>
<th width="60%" align="center">Part II. Opcodes Overview</th>
<td width="20%" align="right"> <a accesskey="n" href="OSC.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="chapter">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a id="OSCNetwork"></a>OSC and Network</h2>
</div>
</div>
</div>
<div class="section">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a id="AbletonLink"></a>Ableton Link Opcodes</h2>
</div>
</div>
</div>
<p>
The purpose of Ableton Link is to synchronize musical time, beat, and phase
between musical applications performing in real time from separate
programs, processes, and network addresses. This is useful, e.g., for laptop
orchestras.
</p>
<p>
Ableton Live is not required to use the Ableton Link protocol, as it is a peer-to-peer protocol.
There is one Link session on the local area network that maintains a global time, tempo, and
beat. Any peer may set the tempo,
and thereafter all peers in the session share that tempo. A process may
have any number of peers (i.e., any number of Link objects). Each peer
may also define its own "quantum" i.e. some multiple of the beat, e.g. a
quantum of 4 might imply 1 beat every measure of 4/4 time. The phase of the time is defined w.r.t
the quantum, e.g. phase 0.5 of a quantum of 4 would be the second beat of
the measure. Peers may read and write timelines with local time, beat, and
phase, counting from when the peer is enabled, but the tempo and beat on
all timelines for all peers in the session will coincide.
</p>
<p>
The first peer in a session determines the initial tempo. After
that, the tempo is changed only, and whenever, any peer explicity calls
the set tempo functon (link_tempo_set, in Csound).
</p>
<p>
The Link tempo is independent of the Csound score tempo. Performances that
need to synchronize the score tempo with the Link tempo may use the tempo
opcode to set the score tempo from the Link tempo; or conversely, set the
Link tempo from the score tempo using the tempoval opcode.
</p>
<p>
Please note, the phase and beat obtained or set by these opcodes is only as
precise as allowed by the duration of Csound's kperiod, the audio driver
used by Csound, network latency and stability, and the system's most precise clock.
</p>
<div class="itemizedlist">
<ul class="itemizedlist" style="list-style-type: disc; ">
<li class="listitem">
<p><a class="link" href="link_create.html" title="link_create"><em class="citetitle">link_create</em></a> - Creates an Ableton Link peer object.</p>
</li>
<li class="listitem">
<p><a class="link" href="link_enable.html" title="link_enable"><em class="citetitle">link_enable</em></a> - Enable/disable synchronization with the network Ableton Link session tempo and beat.</p>
</li>
<li class="listitem">
<p><a class="link" href="link_is_enabled.html" title="link_is_enabled"><em class="citetitle">link_is_enabled</em></a> - Returns whether or not this Ableton Link peer has joined the network session.</p>
</li>
<li class="listitem">
<p><a class="link" href="link_tempo_set.html" title="link_tempo_set"><em class="citetitle">link_tempo_set</em></a> - Sets the tempo for the network's Ableton Link session.</p>
</li>
<li class="listitem">
<p><a class="link" href="link_tempo_get.html" title="link_tempo_get"><em class="citetitle">link_tempo_set</em></a> - Returns the tempo of the network's Ableton Link session.</p>
</li>
<li class="listitem">
<p><a class="link" href="link_beat_get.html" title="link_beat_get"><em class="citetitle">link_beat_get</em></a> - Returns the beat, phase, and current time of Ableton Link for this session for a given quantum.</p>
</li>
<li class="listitem">
<p><a class="link" href="link_metro.html" title="link_metro"><em class="citetitle">link_metro</em></a> - Returns a trigger that is 1 on the beat and 0 otherwise along with the beat, phase, and current time of Ableton Link for this session for a given quantum.</p>
</li>
<li class="listitem">
<p><a class="link" href="link_beat_request.html" title="link_beat_request"><em class="citetitle">link_beat_request</em></a> - Requests a beat with a specific number at a specific time at a given quantum.</p>
</li>
<li class="listitem">
<p><a class="link" href="link_beat_force.html" title="link_beat_force"><em class="citetitle">link_beat_force</em></a> - Forces the network Ableton Link session to adopt a beat with a specific number at a specific time at a given quantum.</p>
</li>
<li class="listitem">
<p><a class="link" href="link_peers.html" title="link_peers"><em class="citetitle">link_peers</em></a> - Returns the number of peers currently joined in the network Ableton Link session.</p>
</li>
</ul>
</div>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="vst4cs.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="PartOpcodesOverview.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="OSC.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">VST for Csound </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> OSC</td>
</tr>
</table>
</div>
</body>
</html>
distrib
>
Mageia
>
7
>
armv7hl
>
media
>
core-release
>
by-pkgid
>
5fcfcb7517038d1f44ab4e478e6e61fa
>
files
>
223
