3.17. Sound Server

3.17.1. Attributes

3.17.2. Description

This element defines the parameters of the sound server for sound synthesis.

The float values of the azimut_refreshing_variation, elevation_refreshing_ variation, and distance_refreshing_variation attributes define the threshold values of azimut, elevation, or distance variations of sound objects under which no sound update message is sent through UDP.

The integer value of the sound_spat_user and sound_spat_head attributes represent the current user and head ids. The float value of the sound_spat_circumf attribute represents the circumference of the current head. The float value of the sound_room_radius attribute represents the radius of the room. The float value of the sound_distance_scale is used to scale distances when sending the message Dist to SPAT.

The string value of the sound_prefix attribute is used to prefix the sound messages that are sent to the udp_remote_clients whose listen_sound_messages attribute is true. Prefixing does not concern the /micro messages associated with active hearpoints; it concerns mostly the messages about room and user characteristics.

3.17.3. Expected content

None.

3.17.4. Example

The example below defines a sound server in which azimut, elevation, and distance are only reported for variations above 10 degrees. Distance is only reported for variations above 0.5 units in world coordinates. The remaining attributes represent the characteristics of the current head and room.

<sound_server azimut_refreshing_variation="10" 
  elevation_refreshing_variation="10" distance_refreshing_variation=".5" 
  sound_spat_user="0" sound_distance_scale="1.0"
  sound_spat_head="1059" sound_spat_circumf="550"
  sound_spat_room_radius="0.1" sound_prefix="/myprefix" />