Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

Changeset 4836 in orxonox.OLD for orxonox/trunk/src/lib/sound


Ignore:
Timestamp:
Jul 12, 2005, 12:33:16 AM (19 years ago)
Author:
bensch
Message:

orxonox/trunk: renamed all the \param → @param and so on in Doxygen tags.
Thanks a lot to the kDevelop team. this took since the last commit :)

Location:
orxonox/trunk/src/lib/sound
Files:
3 edited

Legend:

Unmodified
Added
Removed
  • orxonox/trunk/src/lib/sound/ogg_player.h

    r4750 r4836  
    11/*!
    22 * @file ogg_player.h
    3  * @brief Ogg-Player definition
     3 * Ogg-Player definition
    44 */
    55
  • orxonox/trunk/src/lib/sound/sound_engine.cc

    r4830 r4836  
    3535//////////////////
    3636/**
    37    \brief Creates a Soundbuffer out of an inputfile
    38    \param fileName The name of the File
     37 * Creates a Soundbuffer out of an inputfile
     38 * @param fileName The name of the File
    3939*/
    4040SoundBuffer::SoundBuffer(const char* fileName)
     
    8989//////////////////
    9090/**
    91    \brief creates a SoundSource at position sourceNode with the SoundBuffer buffer
     91 * creates a SoundSource at position sourceNode with the SoundBuffer buffer
    9292*/
    9393SoundSource::SoundSource(SoundBuffer* buffer, PNode* sourceNode)
     
    113113
    114114/**
    115    \brief deletes a SoundSource
     115 * deletes a SoundSource
    116116*/
    117117SoundSource::~SoundSource()
     
    123123
    124124/**
    125    \brief Plays back a SoundSource
     125 * Plays back a SoundSource
    126126*/
    127127void SoundSource::play()
     
    131131
    132132/**
    133    \brief Stops playback of a SoundSource
     133 * Stops playback of a SoundSource
    134134*/
    135135void SoundSource::stop()
     
    139139
    140140/**
    141    \brief Pauses Playback of a SoundSource
     141 * Pauses Playback of a SoundSource
    142142*/
    143143void SoundSource::pause()
     
    147147
    148148/**
    149    \brief Rewinds Playback of a SoundSource
     149 * Rewinds Playback of a SoundSource
    150150*/
    151151void SoundSource::rewind()
     
    155155
    156156/**
    157    \brief sets the RolloffFactor of the Sound emitted from the SoundSource
    158    \param rolloffFactor The Factor described
     157 * sets the RolloffFactor of the Sound emitted from the SoundSource
     158 * @param rolloffFactor The Factor described
    159159
    160160   this tells openAL how fast the Sounds decay outward from the Source
     
    171171//////////////////
    172172/**
    173    \brief standard constructor
     173 * standard constructor
    174174*/
    175175SoundEngine::SoundEngine ()
     
    184184
    185185/**
    186    \brief the singleton reference to this class
     186 * the singleton reference to this class
    187187*/
    188188SoundEngine* SoundEngine::singletonRef = NULL;
    189189
    190190/**
    191    \brief standard deconstructor
     191 * standard deconstructor
    192192
    193193*/
     
    221221
    222222/**
    223    \brief creates a new SoundSource.
    224    \param fileName The Name to load the SoundBuffer from
    225    \param sourceNode The sourceNode to bind this SoundSource to.
    226    \returns The newly created SoundSource
     223 * creates a new SoundSource.
     224 * @param fileName The Name to load the SoundBuffer from
     225 * @param sourceNode The sourceNode to bind this SoundSource to.
     226 * @returns The newly created SoundSource
    227227
    228228   acctualy this is nothing more than a wrapper around the ResourceManager.
     
    235235
    236236/**
    237    \brief sets The listener (normaly the Camera)
     237 * sets The listener (normaly the Camera)
    238238*/
    239239void SoundEngine::setListener(PNode* listener)
     
    243243
    244244/**
    245    \brief Sets the doppler values of openAL
    246    \param dopplerFactor the extent of the doppler-effect
    247    \param dopplerVelocity the Speed the sound travels
     245 * Sets the doppler values of openAL
     246 * @param dopplerFactor the extent of the doppler-effect
     247 * @param dopplerVelocity the Speed the sound travels
    248248*/
    249249void SoundEngine::setDopplerValues(ALfloat dopplerFactor, ALfloat dopplerVelocity)
     
    255255
    256256/**
    257    \brief adds a SoundBuffer to the bufferList of the SoundEngine
    258    \param buffer The buffer to add to the bufferList
     257 * adds a SoundBuffer to the bufferList of the SoundEngine
     258 * @param buffer The buffer to add to the bufferList
    259259*/
    260260void SoundEngine::addBuffer(SoundBuffer* buffer)
     
    264264
    265265/**
    266    \brief removes a SoundBuffer from the bufferList of the SoundEngine
    267    \param buffer The buffer to delete from the SoundEngine
     266 * removes a SoundBuffer from the bufferList of the SoundEngine
     267 * @param buffer The buffer to delete from the SoundEngine
    268268*/
    269269void SoundEngine::removeBuffer(SoundBuffer* buffer)
     
    285285
    286286/**
    287    \brief adds a SoundSource to the sourceList of the SoundEngine
    288    \param source The source to add to the sourceList
     287 * adds a SoundSource to the sourceList of the SoundEngine
     288 * @param source The source to add to the sourceList
    289289*/
    290290void SoundEngine::addSource(SoundSource* source)
     
    294294
    295295/**
    296    \brief removes a SoundSource from the sourceList of the SoundEngine
    297    \param source The source to delete from the SoundEngine
     296 * removes a SoundSource from the sourceList of the SoundEngine
     297 * @param source The source to delete from the SoundEngine
    298298*/
    299299void SoundEngine::removeSource(SoundSource* source)
     
    304304
    305305/**
    306    \brief updates all The positions, Directions and Velocities of all Sounds
     306 * updates all The positions, Directions and Velocities of all Sounds
    307307*/
    308308void SoundEngine::update()
     
    349349
    350350/**
    351    \brief Removes all the Buffers that are not anymore needed by any Sources
     351 * Removes all the Buffers that are not anymore needed by any Sources
    352352*/
    353353void SoundEngine::flushUnusedBuffers()
     
    374374
    375375/**
    376    \brief SourceEngine::flushAllBuffers
     376 * SourceEngine::flushAllBuffers
    377377*/
    378378void SoundEngine::flushAllBuffers()
     
    389389
    390390/**
    391   * @brief SourceEngine::flushAllBuffers
     391  * SourceEngine::flushAllBuffers
    392392 */
    393393void SoundEngine::flushAllSources()
     
    405405
    406406/**
    407    \brief initializes Audio in general
     407 * initializes Audio in general
    408408*/
    409409bool SoundEngine::initAudio()
     
    421421
    422422/**
    423    \brief Transforms AL-errors into something readable
    424    \param err The error found
     423 * Transforms AL-errors into something readable
     424 * @param err The error found
    425425*/
    426426void SoundEngine::PrintALErrorString(ALenum err)
  • orxonox/trunk/src/lib/sound/sound_engine.h

    r4830 r4836  
    11/*!
    22    \file sound_engine.h
    3     \brief Definition of the SoundEngine singleton Class
     3  * Definition of the SoundEngine singleton Class
    44*/
    55
     
    2626  ~SoundBuffer();
    2727
    28   /** \returns the ID of the buffer used in this SoundBuffer */
     28  /** @returns the ID of the buffer used in this SoundBuffer */
    2929  inline ALuint getID() { return this->bufferID; }
    3030
     
    5050
    5151  // development functions
    52   /** \returns The ID of this Source */
     52  /** @returns The ID of this Source */
    5353  inline ALuint getID() const { return this->sourceID; }
    54   /** \returns the SoundBuffer of this Source */
     54  /** @returns the SoundBuffer of this Source */
    5555  inline SoundBuffer* getBuffer() const { return this->buffer; }
    56   /** \returns the SourceNode of this Source */
     56  /** @returns the SourceNode of this Source */
    5757  inline PNode* getNode() const { return this->sourceNode;}
    5858
     
    7272 public:
    7373  virtual ~SoundEngine();
    74   /** \returns a Pointer to the only object of this Class */
     74  /** @returns a Pointer to the only object of this Class */
    7575  inline static SoundEngine* getInstance() { if (!singletonRef) singletonRef = new SoundEngine();  return singletonRef; };
    7676
Note: See TracChangeset for help on using the changeset viewer.