Method BeginSoundFrame

sndlib/hlsoundlib.cpp:638–820

#include "findintersection.h"

void hlsSystem::BeginSoundFrame(bool f_in_game) {
  bool hwsound_support;   // if this is true, sound_render_system is being used
  int16_t *sound_room_list; // these values are only meant for sound render system
  int i, n, counter = 0;
  pos_state listener_pos;
  const int num_samples_this_frame = (int)(Frametime * 22050);
  if (!m_f_hls_system_init)
    return;
  //	determine if we're using hardware for sound support.
  m_ll_sound_ptr->SoundStartFrame();
  // non game sound frame, this, just updates currently playing sounds.
  // placed here to leave early and ensure any further processing involves game only.
  if (!f_in_game) {
    sound_room_list = NULL;
    for (i = 0, counter = 0; i < MAX_SOUND_OBJECTS; i++) {
      if (m_sound_objects[i].m_obj_type_flags && m_sound_objects[i].m_sound_uid != -1) {
        counter++;
        ASSERT(m_sound_objects[i].m_sound_uid > -1);
        if (!m_ll_sound_ptr->IsSoundInstancePlaying(m_sound_objects[i].m_sound_uid)) {
          StopSound(i); // stop any sounds playing.
        }
      }
    }

    goto end_beginsoundframe; // this will handle any remaining processing
  }
  //	FROM HERE ON, WE ASSUME WE'RE IN GAME.
  hwsound_support = (sound_render_start_frame());
  //	define current environment of the listener.
  listener_pos.velocity = &Viewer_object->mtype.phys_info.velocity;
  listener_pos.position = &Viewer_object->pos;
  listener_pos.orient = &Viewer_object->orient;
  listener_pos.roomnum = Viewer_object->roomnum;
  m_ll_sound_ptr->SetListener(&listener_pos);
  // do environmental audio int current room.
  if (!OBJECT_OUTSIDE(Viewer_object)) {
    n = Rooms[Viewer_object->roomnum].env_reverb;
    if (n >= 0) {
      if (m_cur_environment != n) {
        ASSERT(n < N_ENVAUDIO_PRESETS);
        m_ll_sound_ptr->SetGlobalReverbProperties(EnvAudio_Presets[n].volume, EnvAudio_Presets[n].damping,
                                                  EnvAudio_Presets[n].decay);
        m_cur_environment = n;
      }
    }
  } else {
    if (m_cur_environment != ENVAUD_PRESET_MOUNTAINS) {
      n = ENVAUD_PRESET_MOUNTAINS;
      m_ll_sound_ptr->SetGlobalReverbProperties(EnvAudio_Presets[n].volume, EnvAudio_Presets[n].damping,
                                                EnvAudio_Presets[n].decay);
      m_cur_environment = n;
    }
  }
  // render all rooms within a certain range from player (traverse rooms through portals)
  sound_room_list = hwsound_support ? sound_render_audible_rooms(&listener_pos) : NULL;
  //	SoundQ_process();
  // if sound object is outside listener's cone of audibility, emulate the sound.
  //	if sound is audible, then determine its playback properties.