05.05.2013 Views

Huron & SNAP Documentation

Huron & SNAP Documentation

Huron & SNAP Documentation

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Integration under 32 bit Windows<br />

Integration under Unix<br />

API<br />

Spatial Network Audio Protocol<br />

(<strong>SNAP</strong>)<br />

The Spatial Network Audio Protocol (<strong>SNAP</strong>) allows audio<br />

software developers to communicate with a <strong>Huron</strong> workstation<br />

via a TCP/IP network. It simplifies the task of creating and<br />

sending LakeNet messages to the <strong>Huron</strong> by encompassing the<br />

valid LakeNet messages in a distributable module. This module<br />

has a common applications programmer interface (API) for both<br />

Win32 and Unix platforms.<br />

<strong>SNAP</strong> is distributed as source code and a static library to allow<br />

easy integration with new applications under 32 bit Windows<br />

systems or the various Unix platforms.<br />

<strong>SNAP</strong> consists of the files <strong>SNAP</strong>.h and <strong>SNAP</strong>.c. For the<br />

Windows implementation, a library file (<strong>SNAP</strong>.lib) is also<br />

included. When linking a project that uses <strong>SNAP</strong>, link to<br />

<strong>SNAP</strong>.lib and the Windows Sockets library ws2_32.lib.<br />

ws2_32.dll must also be available on the system path.<br />

<strong>SNAP</strong> consists of the files <strong>SNAP</strong>.h and <strong>SNAP</strong>.c. Compile and<br />

link <strong>SNAP</strong>.c with your application. You must defining the<br />

symbol unix. Example:<br />

cc <strong>SNAP</strong>Test.c <strong>SNAP</strong>.c -Dunix<br />

The API is specified fully in the header file <strong>SNAP</strong>.h. An<br />

explanation of the parameters for each function is given below.<br />

The convention for input and output parameters is that inputs<br />

are basic types and outputs are pointers. The exception is<br />

strings, where inputs are declared const and outputs have no<br />

such definition.<br />

HURON TECHNICAL MANUAL PAGE 159

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!