Improved doxygen API doc

This commit is contained in:
Christophe Riccio 2018-08-31 20:23:27 +02:00
parent f6be32ed0d
commit 0b974f0d00
80 changed files with 125 additions and 98 deletions

View File

@ -26,7 +26,6 @@ namespace glm
///
/// @see <a href="http://www.opengl.org/sdk/docs/manglsl/xhtml/abs.xml">GLSL abs man page</a>
/// @see <a href="http://www.opengl.org/registry/doc/GLSLangSpec.4.20.8.pdf">GLSL 4.20.8 specification, section 8.3 Common Functions</a>
/// @see qualifier
template<typename genType>
GLM_FUNC_DECL GLM_CONSTEXPR genType abs(genType x);

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_matrix
/// @{
/// 2 columns of 2 components matrix of double-precision floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_matrix_precision
/// @{
/// 2 columns of 2 components matrix of double-precision floating-point numbers using low precision arithmetic in term of ULPs.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_matrix
/// @{
/// 2 columns of 3 components matrix of double-precision floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_matrix_precision
/// @{
/// 2 columns of 3 components matrix of double-precision floating-point numbers using low precision arithmetic in term of ULPs.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_matrix
/// @{
/// 2 columns of 4 components matrix of double-precision floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_matrix_precision
/// @{
/// 2 columns of 4 components matrix of double-precision floating-point numbers using low precision arithmetic in term of ULPs.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_matrix
/// @{
/// 3 columns of 2 components matrix of double-precision floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_matrix_precision
/// @{
/// 3 columns of 2 components matrix of double-precision floating-point numbers using low precision arithmetic in term of ULPs.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_matrix
/// @{
/// 3 columns of 3 components matrix of double-precision floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_matrix_precision
/// @{
/// 3 columns of 3 components matrix of double-precision floating-point numbers using low precision arithmetic in term of ULPs.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_matrix
/// @{
/// 3 columns of 4 components matrix of double-precision floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_matrix_precision
/// @{
/// 3 columns of 4 components matrix of double-precision floating-point numbers using low precision arithmetic in term of ULPs.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_matrix
/// @{
/// 4 columns of 2 components matrix of double-precision floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_matrix_precision
/// @{
/// 4 columns of 2 components matrix of double-precision floating-point numbers using low precision arithmetic in term of ULPs.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_matrix
/// @{
/// 4 columns of 3 components matrix of double-precision floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_matrix_precision
/// @{
/// 4 columns of 3 components matrix of double-precision floating-point numbers using low precision arithmetic in term of ULPs.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_matrix
/// @{
/// 4 columns of 4 components matrix of double-precision floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_matrix_precision
/// @{
/// 4 columns of 4 components matrix of double-precision floating-point numbers using low precision arithmetic in term of ULPs.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_matrix
/// @{
/// 2 columns of 2 components matrix of single-precision floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_matrix_precision
/// @{
/// 2 columns of 2 components matrix of single-precision floating-point numbers using low precision arithmetic in term of ULPs.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_matrix
/// @{
/// 2 columns of 3 components matrix of single-precision floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_matrix_precision
/// @{
/// 2 columns of 3 components matrix of single-precision floating-point numbers using low precision arithmetic in term of ULPs.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_matrix
/// @{
/// 2 columns of 4 components matrix of single-precision floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_matrix_precision
/// @{
/// 2 columns of 4 components matrix of single-precision floating-point numbers using low precision arithmetic in term of ULPs.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_matrix_precision
/// @{
/// 3 columns of 2 components matrix of single-precision floating-point numbers using low precision arithmetic in term of ULPs.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_matrix
/// @{
/// 3 columns of 3 components matrix of single-precision floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_matrix_precision
/// @{
/// 3 columns of 3 components matrix of single-precision floating-point numbers using low precision arithmetic in term of ULPs.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_matrix
/// @{
/// 3 columns of 4 components matrix of single-precision floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_matrix_precision
/// @{
/// 3 columns of 4 components matrix of single-precision floating-point numbers using low precision arithmetic in term of ULPs.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_matrix
/// @{
/// 4 columns of 2 components matrix of single-precision floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_matrix_precision
/// @{
/// 4 columns of 2 components matrix of single-precision floating-point numbers using low precision arithmetic in term of ULPs.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_matrix
/// @{
/// 4 columns of 3 components matrix of single-precision floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_matrix_precision
/// @{
/// 4 columns of 3 components matrix of single-precision floating-point numbers using low precision arithmetic in term of ULPs.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @ingroup core
/// @ingroup core_matrix
/// @{
/// 4 columns of 4 components matrix of single-precision floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_matrix_precision
/// @{
/// 4 columns of 4 components matrix of single-precision floating-point numbers using low precision arithmetic in term of ULPs.

View File

@ -4,8 +4,6 @@
/// @defgroup ext_matrix_transform GLM_EXT_matrix_transform
/// @ingroup ext
///
/// Include <glm/ext/matrix_transform.hpp> to use the features of this extension.
///
/// Defines functions that generate common transformation matrices.
///
/// The matrices generated by this extension use standard OpenGL fixed-function
@ -14,6 +12,8 @@
/// (perspective, ortho, etc) are designed to expect. The OpenGL compatibility
/// specifications defines the particular layout of this eye space.
///
/// Include <glm/ext/matrix_transform.hpp> to use the features of this extension.
///
/// @see ext_matrix_projection
/// @see ext_matrix_clip_space

View File

@ -4,9 +4,9 @@
/// @defgroup ext_quaternion_double_precision GLM_EXT_quaternion_double_precision
/// @ingroup ext
///
/// Include <glm/ext/quaternion_double_precision.hpp> to use the features of this extension.
///
/// Defines a templated quaternion type and several quaternion operations.
///
/// Include <glm/ext/quaternion_double_precision.hpp> to use the features of this extension.
#pragma once

View File

@ -4,10 +4,10 @@
/// @defgroup ext_quaternion_geometric GLM_EXT_quaternion_geometric
/// @ingroup ext
///
/// Include <glm/ext/quaternion_geometric.hpp> to use the features of this extension.
///
/// Defines a templated quaternion type and several quaternion operations.
///
/// Include <glm/ext/quaternion_geometric.hpp> to use the features of this extension.
///
/// @see core_geometric
/// @see ext_quaternion_float
/// @see ext_quaternion_double

View File

@ -4,10 +4,10 @@
/// @defgroup ext_quaternion_relational GLM_EXT_quaternion_relational
/// @ingroup ext
///
/// Include <glm/ext/quaternion_relational.hpp> to use the features of this extension.
///
/// Defines a templated quaternion type and several quaternion operations.
///
/// Include <glm/ext/quaternion_relational.hpp> to use the features of this extension.
///
/// @see core_vector_relational
/// @see ext_vector_relational
/// @see ext_matrix_relational

View File

@ -4,10 +4,10 @@
/// @defgroup ext_quaternion_transform GLM_EXT_quaternion_transform
/// @ingroup ext
///
/// Include <glm/ext/quaternion_transform.hpp> to use the features of this extension.
///
/// Defines a templated quaternion type and several quaternion operations.
///
/// Include <glm/ext/quaternion_transform.hpp> to use the features of this extension.
///
/// @see ext_quaternion_float
/// @see ext_quaternion_double
/// @see ext_quaternion_exponential

View File

@ -4,10 +4,10 @@
/// @defgroup ext_quaternion_trigonometric GLM_EXT_quaternion_trigonometric
/// @ingroup ext
///
/// Include <glm/ext/quaternion_trigonometric.hpp> to use the features of this extension.
///
/// Defines a templated quaternion type and several quaternion operations.
///
/// Include <glm/ext/quaternion_trigonometric.hpp> to use the features of this extension.
///
/// @see ext_quaternion_float
/// @see ext_quaternion_double
/// @see ext_quaternion_exponential

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_vector
/// @{
/// 2 components vector of boolean.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_vector_precision
/// @{
/// 2 components vector of high qualifier bool numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_vector
/// @{
/// 3 components vector of boolean.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_vector_precision
/// @{
/// 3 components vector of high qualifier bool numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_vector
/// @{
/// 4 components vector of boolean.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_vector_precision
/// @{
/// 4 components vector of high qualifier bool numbers.

View File

@ -4,7 +4,7 @@
/// @defgroup ext_vector_double1 GLM_EXT_vector_double1
/// @ingroup ext
///
/// Expose dvec1 vector type.
/// Exposes double-precision floating point vector type with one component.
///
/// Include <glm/ext/vector_double1.hpp> to use the features of this extension.
///

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_vector
/// @{
/// 2 components vector of double-precision floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_vector_precision
/// @{
/// 2 components vector of high double-qualifier floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_vector
/// @{
/// 3 components vector of double-precision floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_vector_precision
/// @{
/// 3 components vector of high double-qualifier floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_vector
/// @{
/// 4 components vector of double-precision floating-point numbers.

View File

@ -7,7 +7,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_vector_precision
/// @{
/// 4 components vector of high double-qualifier floating-point numbers.

View File

@ -4,7 +4,7 @@
/// @defgroup ext_vector_float1 GLM_EXT_vector_float1
/// @ingroup ext
///
/// Floating point vector type with one component.
/// Exposes single-precision floating point vector type with one component.
///
/// Include <glm/ext/vector_float1.hpp> to use the features of this extension.
///

View File

@ -4,10 +4,10 @@
/// @defgroup ext_vector_float1_precision GLM_EXT_vector_float1_precision
/// @ingroup ext
///
/// Include <glm/ext/vector_float1_precision.hpp> to use the features of this extension.
///
/// Exposes highp_vec1, mediump_vec1 and lowp_vec1 types.
///
/// Include <glm/ext/vector_float1_precision.hpp> to use the features of this extension.
///
/// @see ext_vector_float1 extension.
#pragma once

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_vector
/// @{
/// 2 components vector of single-precision floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_vector_precision
/// @{
/// 2 components vector of high single-qualifier floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_vector
/// @{
/// 3 components vector of single-precision floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_vector_precision
/// @{
/// 3 components vector of high single-qualifier floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_vector
/// @{
/// 4 components vector of single-precision floating-point numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_vector_precision
/// @{
/// 4 components vector of high single-qualifier floating-point numbers.

View File

@ -4,7 +4,7 @@
/// @defgroup ext_vector_int1_precision GLM_EXT_vector_int1_precision
/// @ingroup ext
///
/// Add Exposes highp_ivec1, mediump_ivec1 and lowp_ivec1 types.
/// Exposes highp_ivec1, mediump_ivec1 and lowp_ivec1 types.
///
/// Include <glm/ext/vector_int1_precision.hpp> to use the features of this extension.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_vector
/// @{
/// 2 components vector of signed integer numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_vector_precision
/// @{
/// 2 components vector of high qualifier signed integer numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_vector
/// @{
/// 3 components vector of signed integer numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_vector_precision
/// @{
/// 3 components vector of high qualifier signed integer numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_vector
/// @{
/// 4 components vector of signed integer numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_vector_precision
/// @{
/// 4 components vector of high qualifier signed integer numbers.

View File

@ -4,9 +4,9 @@
/// @defgroup ext_vector_uint1_precision GLM_EXT_vector_uint1_precision
/// @ingroup ext
///
/// Include <glm/ext/vector_uint1_precision.hpp> to use the features of this extension.
/// Exposes highp_uvec1, mediump_uvec1 and lowp_uvec1 types.
///
/// Add Exposes highp_uvec1, mediump_uvec1 and lowp_uvec1 types.
/// Include <glm/ext/vector_uint1_precision.hpp> to use the features of this extension.
#pragma once

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_vector
/// @{
/// 2 components vector of unsigned integer numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_vector_precision
/// @{
/// 2 components vector of high qualifier unsigned integer numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_vector
/// @{
/// 3 components vector of unsigned integer numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_vector_precision
/// @{
/// 3 components vector of high qualifier unsigned integer numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core
/// @addtogroup core_vector
/// @{
/// 4 components vector of unsigned integer numbers.

View File

@ -6,7 +6,7 @@
namespace glm
{
/// @addtogroup core_precision
/// @addtogroup core_vector_precision
/// @{
/// 4 components vector of high qualifier unsigned integer numbers.

View File

@ -6,9 +6,7 @@
/// @brief Features that implement in C++ the GLSL specification as closely as possible.
///
/// The GLM core consists of C++ types that mirror GLSL types and
/// C++ functions that mirror the GLSL functions. It also includes
/// @ref core_precision "a set of qualifier-based types" that can be used in the appropriate
/// functions.
/// C++ functions that mirror the GLSL functions.
///
/// The best documentation for GLM Core is the current GLSL specification,
/// <a href="http://www.opengl.org/registry/doc/GLSLangSpec.4.20.8.clean.pdf">version 4.2
@ -16,13 +14,21 @@
///
/// GLM core functionalities require <glm/glm.hpp> to be included to be used.
///
/// @defgroup core_precision Precision types
///
/// @brief Non-GLSL types that are used to define qualifier-based types.
/// @defgroup core_vector Vector types
///
/// The GLSL language allows the user to define the qualifier of a particular variable.
/// In OpenGL's GLSL, these qualifier qualifiers have no effect; they are there for compatibility
/// with OpenGL ES's qualifier qualifiers, where they @em do have an effect.
/// Vector types of two to four components with an exhaustive set of operators.
///
/// @ingroup core
///
///
/// @defgroup core_vector_precision Vector types with precision qualifiers
///
/// @brief Vector types with precision qualifiers which may result in various precision in term of ULPs
///
/// GLSL allows defining qualifiers for particular variables.
/// With OpenGL's GLSL, these qualifiers have no effect; they are there for compatibility,
/// with OpenGL ES's GLSL, these qualifiers do have an effect.
///
/// C++ has no language equivalent to qualifier qualifiers. So GLM provides the next-best thing:
/// a number of typedefs that use a particular qualifier.
@ -31,6 +37,31 @@
///
/// @ingroup core
///
///
/// @defgroup core_matrix Matrix types
///
/// Matrix types of with C columns and R rows where C and R are values between 2 to 4 included.
/// These types have exhaustive sets of operators.
///
/// @ingroup core
///
///
/// @defgroup core_matrix_precision Matrix types with precision qualifiers
///
/// @brief Matrix types with precision qualifiers which may result in various precision in term of ULPs
///
/// GLSL allows defining qualifiers for particular variables.
/// With OpenGL's GLSL, these qualifiers have no effect; they are there for compatibility,
/// with OpenGL ES's GLSL, these qualifiers do have an effect.
///
/// C++ has no language equivalent to qualifier qualifiers. So GLM provides the next-best thing:
/// a number of typedefs that use a particular qualifier.
///
/// None of these types make any guarantees about the actual qualifier used.
///
/// @ingroup core
///
///
/// @defgroup ext Stable extensions
///
/// @brief Additional features not specified by GLSL specification.
@ -40,6 +71,7 @@
/// Even if it's highly unrecommended, it's possible to include all the extensions at once by
/// including <glm/ext.hpp>. Otherwise, each extension needs to be included a specific file.
///
///
/// @defgroup gtc Recommended extensions
///
/// @brief Additional features not specified by GLSL specification.
@ -49,6 +81,7 @@
/// Even if it's highly unrecommended, it's possible to include all the extensions at once by
/// including <glm/ext.hpp>. Otherwise, each extension needs to be included a specific file.
///
///
/// @defgroup gtx Experimental extensions
///
/// @brief Experimental features not specified by GLSL specification.

View File

@ -10,9 +10,6 @@
/// Include <glm/gtc/type_precision.hpp> to use the features of this extension.
///
/// Defines specific C++-based qualifier types.
///
/// @ref core_precision defines types based on GLSL's qualifier qualifiers. This
/// extension defines types based on explicitly-sized C++ data types.
#pragma once

View File

@ -10,8 +10,6 @@
/// Include <glm/gtx/type_aligned.hpp> to use the features of this extension.
///
/// Defines aligned types.
///
/// @ref core_precision defines aligned types.
#pragma once