diff options
author | Ben Boeckel <MathStuf@gmail.com> | 2009-01-18 17:49:47 -0500 |
---|---|---|
committer | Ben Boeckel <MathStuf@gmail.com> | 2009-01-18 17:49:47 -0500 |
commit | a77b099ce425299c3de1c3e1e9c067f97425c003 (patch) | |
tree | 901502c2083541c70db35b17f8f08efc1a5c51e8 | |
parent | 68442527a1bf48c56878faea2eb6970eb89cb5d7 (diff) | |
download | sigen-a77b099ce425299c3de1c3e1e9c067f97425c003.tar.gz sigen-a77b099ce425299c3de1c3e1e9c067f97425c003.tar.xz sigen-a77b099ce425299c3de1c3e1e9c067f97425c003.zip |
Added Sound documentation
-rw-r--r-- | sigmod/Sound.cpp | 4 | ||||
-rw-r--r-- | sigmod/Sound.h | 91 |
2 files changed, 94 insertions, 1 deletions
diff --git a/sigmod/Sound.cpp b/sigmod/Sound.cpp index e5ad5ce5..32a66994 100644 --- a/sigmod/Sound.cpp +++ b/sigmod/Sound.cpp @@ -15,6 +15,10 @@ * with this program. If not, see <http://www.gnu.org/licenses/>. */ +/** + * \file sigmod/Sound.cpp + */ + // Header include #include "Sound.h" diff --git a/sigmod/Sound.h b/sigmod/Sound.h index 30b26532..124d587c 100644 --- a/sigmod/Sound.h +++ b/sigmod/Sound.h @@ -1,5 +1,5 @@ /* - * Copyright 2007-2008 Ben Boeckel <MathStuf@gmail.com> + * Copyright 2007-2009 Ben Boeckel <MathStuf@gmail.com> * * 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 @@ -15,6 +15,10 @@ * with this program. If not, see <http://www.gnu.org/licenses/>. */ +/** + * \file sigmod/Sound.h + */ + #ifndef SIGMOD_SOUND #define SIGMOD_SOUND @@ -30,35 +34,120 @@ namespace Sigmod // Forward declarations class Sigmod; +/** + * \class Sigmod::Sound Sound.h sigmod/Sound.h + * \brief Class describing a sound. + * + * Any sound in the sigmod must be declared as an instance of this class. + * Sounds can be effects (can make as many as desired, but stop once done + * playing) or music (can only have one instance and loops by default). + */ class SIGMOD_EXPORT Sound : public Object { Q_OBJECT Q_ENUMS(Type) public: + /** + * \enum Type + * \brief The type of the sound stored. + */ enum Type { SoundEffect = 0, Music = 1 }; + /** + * \var TypeStr + * String values for the types of sound. + */ static const QStringList TypeStr; + /** + * Copy constructor. + * + * \param sound The sound to copy. + */ Sound(const Sound& sound); + /** + * Create a new sound belonging to \p parent and id \p id. + * + * \param parent The parent of the sound. + * \param id The id number for the sound. + */ Sound(const Sigmod* parent, const int id); + /** + * Data copy constructor. Copies the data from \p sound as a child of \p parent with id \p id. + * + * \param sound The sound to copy the data from. + * \param parent The parent of the sound. + * \param id The id number for the sound. + */ Sound(const Sound& sound, const Sigmod* parent, const int id); + /** + * XML data constructor. + * + * \param xml The XML structure to extract the data from. + * \param parent The parent of the sound. + * \param id The id number for the sound. + */ Sound(const QDomElement& xml, const Sigmod* parent, const int id = -1); + /** + * Check to make sure the sound's values are valid. + */ void validate(); + /** + * Load data from XML. + * + * \param xml The XML structure to extract data from. + */ void load(const QDomElement& xml); + /** + * Get the data for the sound in XML format. + * + * \return The XML structure representing the sound. + */ QDomElement save() const; + /** + * Sets the name of the sound. This is only used internally. + * + * \param name The name of the sound. + */ void setName(const QString& name); + /** + * Sets the type of the sound. + * + * \param type The type of the sound. + */ void setType(const Type type); + /** + * Sets the data for the sound. Any formats supported by \link http://phonon.kde.org/ Phonon \endlink + * are supported here. + * + * \param data The data for the sound. + */ void setData(const QByteArray& data); + /** + * \sa setName + * + * \return The name of the sound. + */ QString name() const; + /** + * \sa setType + * + * \return The type of sound. + */ Type type() const; + /** + * \sa setData + * + * \return The data for the sound. + */ QByteArray data() const; bool nameCheck(const QString& name) const; |