source: orxonox.OLD/trunk/src/lib/sound/sound_source.cc @ 7315

/*
   orxonox - the future of 3D-vertical-scrollers

   Copyright (C) 2004 orx

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2, or (at your option)
   any later version.

   ### File Specific:
   main-programmer: Benjamin Grauer
   co-programmer: ...
*/

#define DEBUG_SPECIAL_MODULE DEBUG_MODULE_SOUND

#include "sound_source.h"
#include "sound_engine.h"

#include "alincl.h"
#include "compiler.h"

using namespace std;

/**
 * @brief creates a SoundSource at position sourceNode with the SoundBuffer buffer
 */
SoundSource::SoundSource(const PNode* sourceNode, const SoundBuffer* buffer)
{
  this->setClassID(CL_SOUND_SOURCE, "SoundSource");

  // adding the Source to the SourcesList of the SoundEngine
  this->buffer = buffer;
  this->sourceNode = sourceNode;

  this->sourceID = 0;
  this->bPlay = false;
}

/**
 * @brief construct a SoundSource out of the another soundSource
 * @param source the Source to create this source from.
 *
 * Copies the buffer from source to this Source.
 * Acquires a new SourceID if source is Playing.
 */
SoundSource::SoundSource(const SoundSource& source)
{
  this->setClassID(CL_SOUND_SOURCE, "SoundSource");

  // adding the Source to the SourcesList of the SoundEngine
  this->buffer = source.buffer;
  this->sourceNode = source.sourceNode;

  this->sourceID = 0;
  if (source.bPlay == true)
  {
    this->bPlay = true;
    SoundEngine::getInstance()->popALSource(this->sourceID);
  }
  else
    this->bPlay = false;
}

/**
 * @brief paste a copy of the source into this Source.
 * @param source the SoundSource to paste into this one.
 * @returns a Reference to this Source.
 *
 */
SoundSource& SoundSource::operator=(const SoundSource& source)
{
  this->buffer = source.buffer;
  this->sourceNode = sourceNode;

  if (source.bPlay)
    this->play();
  else
    this->stop();
}

/**
 * @brief compares two Sources with each other.
 * @param source the Source to compare against this One.
 * Two Sources are the same, if the PNodes match, and the Sound Played are the same.
 * The alSource must not match, because no two Sources can have the same alSource.
 */
bool SoundSource::operator==(const SoundSource& source)
{
  return (this->buffer == source.buffer &&
          this->bPlay == source.bPlay &&
          this->sourceNode == source.sourceNode);
}

/**
 * @brief deletes a SoundSource
 */
SoundSource::~SoundSource()
{
  this->stop();
}

/**
 * @brief Plays back a SoundSource
 */
void SoundSource::play()
{
  if (this->sourceID == 0)
    SoundEngine::getInstance()->popALSource(this->sourceID);
  alSourcePlay(this->sourceID);
  if (DEBUG >= 3)
    SoundEngine::checkError("Play Source", __LINE__);
  this->bPlay = true;
}

/**
 * Plays back buffer on this Source
 * @param buffer the buffer to play back on this Source
 */
void SoundSource::play(const SoundBuffer* buffer)
{
  if (unlikely(this->sourceID == 0))
  {
    SoundEngine::getInstance()->popALSource(this->sourceID);
    if (sourceID == 0)
    {
      PRINTF(2)("No more Free source\n");
      return;
    }
  }
  //  assert (this->sourceID != 0);

  alSourceStop(this->sourceID);
  alSourcei (this->sourceID, AL_BUFFER, buffer->getID());
  alSourcePlay(this->sourceID);

  if (unlikely(this->buffer != NULL))
    alSourcei (this->sourceID, AL_BUFFER, this->buffer->getID());
  this->bPlay = true;

  if (DEBUG >= 3)
    SoundEngine::checkError("Play Source", __LINE__);
}

/**
 * @brief Stops playback of a SoundSource
 */
void SoundSource::stop()
{
  this->bPlay = false;
  if (this->sourceID != 0)
  {
    alSourceStop(this->sourceID);
    if (DEBUG >= 3)
      SoundEngine::checkError("StopSource", __LINE__);
    alSourcei(this->sourceID, AL_BUFFER, 0);
    SoundEngine::getInstance()->pushALSource(this->sourceID);
    this->sourceID = 0;
  }
}

/**
 * @brief Pauses Playback of a SoundSource
 */
void SoundSource::pause()
{
  alSourcePause(this->sourceID);
  if (DEBUG >= 3)
    SoundEngine::checkError("Pause Source", __LINE__);
}

/**
 * @brief Rewinds Playback of a SoundSource
 */
void SoundSource::rewind()
{
  alSourceRewind(this->sourceID);

  if (DEBUG >= 3)
    SoundEngine::checkError("Rewind Source", __LINE__);
}

/**
 * @brief sets the RolloffFactor of the Sound emitted from the SoundSource
 * @param rolloffFactor The Factor described
 *
 * this tells openAL how fast the Sounds decay outward from the Source
 */
void SoundSource::setRolloffFactor(ALfloat rolloffFactor)
{
  alSourcef(this->sourceID, AL_ROLLOFF_FACTOR, rolloffFactor);

  if (DEBUG >= 3)
    SoundEngine::checkError("Set Source Rolloff-factor", __LINE__);
}