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.

OTHER SIMULATION TOOLS<br />

This command returns a <strong>Huron</strong>Ack packet to the remote<br />

computer. The cmd field of the <strong>Huron</strong>Ack packet will contain<br />

<strong>SNAP</strong>LoadRoom and the data field will contain the<br />

buffernumber that the room acoustic files were loaded into. If<br />

the Space Array was unable to load the data files it will return -<br />

1 in the data field of the <strong>Huron</strong>Ack packet.<br />

This buffer may also be used to switch between and clear rooms<br />

using the <strong>SNAP</strong>SetRoom and <strong>SNAP</strong>ClearRoom commands.<br />

in const char* szPath The directory path of the data files<br />

<strong>SNAP</strong>SetRoom<br />

The Space Array can be loaded with a number of different room<br />

acoustic definitions. Each room is assigned a buffer number.<br />

This command can be used to switch the Space Array’s room<br />

acoustic definition buffer number.<br />

<strong>SNAP</strong>SetRoom must be issued before loading a room into any<br />

buffer but the default one (buffer 0).<br />

in long lBuffer The buffer number of the new room<br />

<strong>SNAP</strong>ClearRoom<br />

The Space Array can be loaded with a number of different room<br />

acoustic definitions. Each room is assigned a buffer number.<br />

This command can be sent to remove the acoustics loaded in the<br />

defined buffer number.<br />

in long lBuffer The buffer number of the room to remove<br />

<strong>SNAP</strong>SetMinDistance<br />

The Space Array has a setting called Minimum Source Distance<br />

that is measured in meters. This specifies a sphere around the<br />

listener’s position with a radius of the minimum source distance<br />

value. If a sound object comes within this circle, its volume<br />

will remain fixed at the level on the edge of circle and its<br />

directionality will gradually turn to omni-directional as it<br />

approaches the listener’s position. The minimum source<br />

distance can be set using this command.<br />

in float fMSD The minimum source distance in meters<br />

HURON TECHNICAL MANUAL PAGE 168

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

Saved successfully!

Ooh no, something went wrong!