Skip to content
Snippets Groups Projects
Commit 50292bda authored by Shon Ferguson's avatar Shon Ferguson
Browse files

Addressed Doxygen warnings.

parent 5173f864
No related branches found
No related tags found
No related merge requests found
......@@ -160,7 +160,7 @@ NIFLIB_API void WriteNifTree( ostream & in, NiObject * root, const NifInfo & inf
/*!
* Writes a bunch of files given a base file name, and a pointer to the root object of the Nif file tree.
* \param[in] file_name The desired file name for the base NIF file. This name serves as the basis for the names of any Kf files and Kfm files as well. The path is relative to the working directory unless a full path is specified.
* \param[in] root The root object to start from when writing out the NIF file.
* \param[in] root_object The root object to start from when writing out the NIF file.
* \param[in] info A NifInfo structure that contains information such as the version of the NIF file to create.
* \param[in] export_files What files to write: NIF, NIF + KF + KFM, NIF + KF's + KFM, KF only, KF's only
* \param[in] kf_type The KF type (Morrowind style, DAoC style, CivIV style, ...)
......@@ -208,7 +208,7 @@ NIFLIB_API Ref<NiNode> FindCommonAncestor( const vector< Ref<NiAVObject> > & obj
/*!
* Returns a list of all the ancestors of a given NiAVObject
* \param leaf[in] The NiAVObject to list the ancestors of.
* \param[in] leaf The NiAVObject to list the ancestors of.
* \return A list containing all the ancestors of the given NiAVObject
*/
NIFLIB_API list< Ref<NiNode> > ListAncestors( NiAVObject * leaf );
......@@ -258,7 +258,7 @@ While it is possible to use the pre-compiled DLL file if you are using Microsoft
If you need help to do this, there is information about it on our main website here: <a href="http://www.niftools.org/wiki/index.php/Niflib/Compile">Compiling Niflib</a>.
\section include Including the Library
\section include_lib Including the Library
Visual Studio 2005 is the preferred compiler for Niflib as this is the platform that all development is done on. The instructions in this guide assume that you are using this compiler. If you do not have a copy, you can <a href="http://msdn.microsoft.com/vstudio/express/downloads/default.aspx">download Microsoft Visual C++ 2005 Express</a> for free from Microsoft. Niflib should work on other compilers, and is tested on GCC from time to time, but you will have to figure out how to use those compilers on your own.
......@@ -270,24 +270,34 @@ Dynamic linking means that your program will include a Niflib DLL file which the
These are the project settings that you should change to use each combination of Debug/Release and DLL/Static. This assumes that you've already created a default empty project with Debug and Release configurations, and are altering those with these additional settings. It also assumes that you're using the provided Niflib project file to build Niflib, and have added Niflib's lib and include folders to the proper paths in the Tools > Options screen under Projects and Solutions > VC++ Directories.
DLL Release:
\subsection dll_release DLL Release:
Configuration Properties > C/C++ > Code Generation = Multi-threaded DLL (/MD)
Configuration Properties > Linker > Additional Dependencies = niflib_dll.lib
DLL Debug:
\subsection dll_debug DLL Debug:
Configuration Properties > C/C++ > Code Generation = Multi-threaded Debug DLL (/MDd)
Configuration Properties > Linker > Additional Dependencies = niflib_dll_debug.lib
Static Release:
\subsection static_release Static Release:
Configuration Properties > C/C++ > Code Generation = Multi-threaded (/MT)
Configuration Properties > Preprocessor > Preprocessor Definitions: (Add this to the end of what is already there, separated by semicolons) NIFLIB_STATIC_LINK
Configuration Properties > Linker > Additional Dependencies = niflib_static.lib
Static Debug:
Configuration Properties > C/C++ > Code Generation = Multi-threaded Debug (/MTd)
Configuration Properties > Preprocessor > Preprocessor Definitions: (Add this to the end of what is already there, separated by semicolons) NIFLIB_STATIC_LINK
\subsection static_debug Static Debug:
Configuration Properties > C/C++ > Code Generation = Multi-threaded Debug (/MTd)
Configuration Properties > Linker > Additional Dependencies = niflib_static_debug.lib
Configuration Properties > Preprocessor > Preprocessor Definitions: (Add this to the end of what is already there, separated by semicolons) NIFLIB_STATIC_LINK
With that out of the way, you can start writing your source code and include the main Niflib header file:
\code
......@@ -302,7 +312,7 @@ In addition to the main header file, there are also separate headers for each ob
You will have one such line in your source code for each NIF object that your program needs access to.
Niflib also wraps all its functions in the "Niflib" namespace. So, depending on your needs, you can either gain access to all Niflib symbols with a using directive that follows the #include statements like this:
Niflib also wraps all its functions in the "Niflib" namespace. So, depending on your needs, you can either gain access to all Niflib symbols with a using directive that follows the include statements like this:
\code
using namespace Niflib;
......
......@@ -143,7 +143,7 @@ public:
/*!
* Retrieves the property that matches the specified type, if there is one. A valid object should not have more than one property of the same type. Properties specify various charactaristics of the object that affect rendering. They may be shared among objects.
* \param[in] compare-to The type constant of the desired property type.
* \param[in] compare_to The type constant of the desired property type.
* \return The property that matches the specified type, or NULL if there isn't a match.
* \sa NiObject::TypeConst
*/
......@@ -217,7 +217,7 @@ public:
/*!
* Sets the current visibility of this object by altering its flag data.
* \param[in] Whether or not the object will now be visible. True if visible, false otherwise.
* \param[in] n Whether or not the object will now be visible. True if visible, false otherwise.
*/
NIFLIB_API void SetVisibility( bool n );
......
......@@ -97,7 +97,7 @@ public:
/*!
* Set the data object that refers to LOD level information.
* \param[in] The new LOD level data object or NULL to clear the current one.
* \param[in] value The new LOD level data object or NULL to clear the current one.
*/
NIFLIB_API void SetLODLevelData( Ref<NiLODData > value );
......
......@@ -85,7 +85,7 @@ public:
/*!
* Retrieves all AV Object children from this node. These are a sub-leafs in the scene graph contained in a NIF file. Each AV Object can only be the child of one node.
* \param[in] A list of all the AV Objects that are children of this node in the scene graph.
* \return A list of all the AV Objects that are children of this node in the scene graph.
*/
NIFLIB_API vector< Ref<NiAVObject> > GetChildren() const;
......
......@@ -191,7 +191,7 @@ public:
/*!
* Sets a Playstation 2 - specific value. Can just be left at the default of 0.
* \param[in] The new PS2 L value.
* \param[in] value The new PS2 L value.
*/
NIFLIB_API void SetPs2L( unsigned short value );
......@@ -203,7 +203,7 @@ public:
/*!
* Sets a Playstation 2 - specific value. Can just be left at the default of 0xFFB5.
* \param[in] The new PS2 K value.
* \param[in] value The new PS2 K value.
*/
NIFLIB_API void SetPs2K( unsigned short value );
......
......@@ -65,7 +65,7 @@ public:
/*!
* Sets the dimentions of the box.
* \param The new dimentions for the bounding box.
* \param value The new dimentions for the bounding box.
*/
NIFLIB_API void SetDimensions( const Vector3 & value );
......
......@@ -89,7 +89,7 @@ public:
/*!
* Sets the second capsule radius. Seems to match the first capsule radius.
* \param value[in] The new second capsule radius.
* \param[in] value The new second capsule radius.
*/
NIFLIB_API void SetRadius1( float value );
......@@ -113,7 +113,7 @@ public:
/*!
* Sets the third capsule radius. Seems to match the second capsule radius.
* \param value[in] The new third capsule radius.
* \param[in] value The new third capsule radius.
*/
NIFLIB_API void SetRadius2( float value );
......
......@@ -77,9 +77,9 @@ public:
/*!
* Sets the number of NiTriStripsData objects referenced by this shape.
* \param[in] n The new number of NiTriStripsData objects.
* \param[in] i The new number of NiTriStripsData objects.
*/
NIFLIB_API void SetNumStripsData(int i);
NIFLIB_API void SetNumStripsData( int i );
/*!
* Sets the NiTriStripsData object referenced by this shape at the specified index.
......
......@@ -64,7 +64,7 @@ public:
/*!
* Retrieves the shape object that this body is using.
* \param[in] value The shape object being used by this body.
* \return The shape object being used by this body.
*/
NIFLIB_API Ref<bhkShape > GetShape() const;
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment