glm.hpp 4.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137
  1. /// @ref core
  2. /// @file glm/glm.hpp
  3. ///
  4. /// @mainpage OpenGL Mathematics (GLM)
  5. /// - Website: <a href="https://glm.g-truc.net">glm.g-truc.net</a>
  6. /// - <a href="modules.html">GLM API documentation</a>
  7. /// - <a href="https://github.com/g-truc/glm/blob/master/manual.md">GLM Manual</a>
  8. ///
  9. /// @defgroup core Core features
  10. ///
  11. /// @brief Features that implement in C++ the GLSL specification as closely as possible.
  12. ///
  13. /// The GLM core consists of C++ types that mirror GLSL types and
  14. /// C++ functions that mirror the GLSL functions.
  15. ///
  16. /// The best documentation for GLM Core is the current GLSL specification,
  17. /// <a href="http://www.opengl.org/registry/doc/GLSLangSpec.4.20.8.clean.pdf">version 4.2
  18. /// (pdf file)</a>.
  19. ///
  20. /// GLM core functionalities require <glm/glm.hpp> to be included to be used.
  21. ///
  22. ///
  23. /// @defgroup core_vector Vector types
  24. ///
  25. /// Vector types of two to four components with an exhaustive set of operators.
  26. ///
  27. /// @ingroup core
  28. ///
  29. ///
  30. /// @defgroup core_vector_precision Vector types with precision qualifiers
  31. ///
  32. /// @brief Vector types with precision qualifiers which may result in various precision in term of ULPs
  33. ///
  34. /// GLSL allows defining qualifiers for particular variables.
  35. /// With OpenGL's GLSL, these qualifiers have no effect; they are there for compatibility,
  36. /// with OpenGL ES's GLSL, these qualifiers do have an effect.
  37. ///
  38. /// C++ has no language equivalent to qualifier qualifiers. So GLM provides the next-best thing:
  39. /// a number of typedefs that use a particular qualifier.
  40. ///
  41. /// None of these types make any guarantees about the actual qualifier used.
  42. ///
  43. /// @ingroup core
  44. ///
  45. ///
  46. /// @defgroup core_matrix Matrix types
  47. ///
  48. /// Matrix types of with C columns and R rows where C and R are values between 2 to 4 included.
  49. /// These types have exhaustive sets of operators.
  50. ///
  51. /// @ingroup core
  52. ///
  53. ///
  54. /// @defgroup core_matrix_precision Matrix types with precision qualifiers
  55. ///
  56. /// @brief Matrix types with precision qualifiers which may result in various precision in term of ULPs
  57. ///
  58. /// GLSL allows defining qualifiers for particular variables.
  59. /// With OpenGL's GLSL, these qualifiers have no effect; they are there for compatibility,
  60. /// with OpenGL ES's GLSL, these qualifiers do have an effect.
  61. ///
  62. /// C++ has no language equivalent to qualifier qualifiers. So GLM provides the next-best thing:
  63. /// a number of typedefs that use a particular qualifier.
  64. ///
  65. /// None of these types make any guarantees about the actual qualifier used.
  66. ///
  67. /// @ingroup core
  68. ///
  69. ///
  70. /// @defgroup ext Stable extensions
  71. ///
  72. /// @brief Additional features not specified by GLSL specification.
  73. ///
  74. /// EXT extensions are fully tested and documented.
  75. ///
  76. /// Even if it's highly unrecommended, it's possible to include all the extensions at once by
  77. /// including <glm/ext.hpp>. Otherwise, each extension needs to be included a specific file.
  78. ///
  79. ///
  80. /// @defgroup gtc Recommended extensions
  81. ///
  82. /// @brief Additional features not specified by GLSL specification.
  83. ///
  84. /// GTC extensions aim to be stable with tests and documentation.
  85. ///
  86. /// Even if it's highly unrecommended, it's possible to include all the extensions at once by
  87. /// including <glm/ext.hpp>. Otherwise, each extension needs to be included a specific file.
  88. ///
  89. ///
  90. /// @defgroup gtx Experimental extensions
  91. ///
  92. /// @brief Experimental features not specified by GLSL specification.
  93. ///
  94. /// Experimental extensions are useful functions and types, but the development of
  95. /// their API and functionality is not necessarily stable. They can change
  96. /// substantially between versions. Backwards compatibility is not much of an issue
  97. /// for them.
  98. ///
  99. /// Even if it's highly unrecommended, it's possible to include all the extensions
  100. /// at once by including <glm/ext.hpp>. Otherwise, each extension needs to be
  101. /// included a specific file.
  102. ///
  103. #include "detail/_fixes.hpp"
  104. #include "detail/setup.hpp"
  105. #pragma once
  106. #include <cmath>
  107. #include <climits>
  108. #include <cfloat>
  109. #include <limits>
  110. #include <cassert>
  111. #include "fwd.hpp"
  112. #include "vec2.hpp"
  113. #include "vec3.hpp"
  114. #include "vec4.hpp"
  115. #include "mat2x2.hpp"
  116. #include "mat2x3.hpp"
  117. #include "mat2x4.hpp"
  118. #include "mat3x2.hpp"
  119. #include "mat3x3.hpp"
  120. #include "mat3x4.hpp"
  121. #include "mat4x2.hpp"
  122. #include "mat4x3.hpp"
  123. #include "mat4x4.hpp"
  124. #include "trigonometric.hpp"
  125. #include "exponential.hpp"
  126. #include "common.hpp"
  127. #include "packing.hpp"
  128. #include "geometric.hpp"
  129. #include "matrix.hpp"
  130. #include "vector_relational.hpp"
  131. #include "integer.hpp"