pango 3.1.1-x64-mingw32 → 3.1.2-x64-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (306) hide show
  1. checksums.yaml +4 -4
  2. data/Rakefile +27 -5
  3. data/ext/pango/depend +2 -2
  4. data/ext/pango/extconf.rb +32 -28
  5. data/ext/pango/pango.def +0 -16
  6. data/ext/pango/rb-pango-attr-list.c +64 -0
  7. data/ext/pango/rb-pango-attribute.c +147 -0
  8. data/ext/pango/rb-pango-context.c +79 -0
  9. data/ext/pango/{rbpangoconversions.h → rb-pango-conversions.h} +4 -6
  10. data/ext/pango/rb-pango-private.h +27 -0
  11. data/ext/pango/rb-pango.c +32 -0
  12. data/ext/pango/rb-pango.h +29 -0
  13. data/extconf.rb +25 -9
  14. data/lib/2.2/pango.so +0 -0
  15. data/lib/2.3/pango.so +0 -0
  16. data/lib/2.4/pango.so +0 -0
  17. data/lib/pango.rb +24 -68
  18. data/lib/pango/cairo-loader.rb +63 -0
  19. data/lib/pango/color.rb +31 -0
  20. data/lib/pango/deprecated.rb +37 -0
  21. data/lib/pango/font-description.rb +29 -0
  22. data/lib/pango/language.rb +29 -0
  23. data/lib/pango/layout.rb +41 -0
  24. data/lib/pango/loader.rb +87 -0
  25. data/lib/pango/markup.rb +31 -0
  26. data/lib/pango/matrix.rb +64 -0
  27. data/lib/pango/rectangle.rb +28 -0
  28. data/lib/pango/version.rb +30 -0
  29. data/test/pango-test-utils.rb +7 -7
  30. data/test/run-test.rb +34 -8
  31. data/test/test-attr-list.rb +28 -0
  32. data/test/test-color.rb +1 -3
  33. data/test/test-context.rb +4 -4
  34. data/test/test-enum.rb +37 -0
  35. data/test/test-font-description.rb +31 -0
  36. data/test/test-language.rb +2 -1
  37. data/test/test-layout.rb +12 -0
  38. data/test/test-markup.rb +30 -0
  39. data/test/test-matrix.rb +131 -5
  40. data/test/test-rectangle.rb +16 -3
  41. data/vendor/local/bin/derb.exe +0 -0
  42. data/vendor/local/bin/genbrk.exe +0 -0
  43. data/vendor/local/bin/genccode.exe +0 -0
  44. data/vendor/local/bin/gencfu.exe +0 -0
  45. data/vendor/local/bin/gencmn.exe +0 -0
  46. data/vendor/local/bin/gencnval.exe +0 -0
  47. data/vendor/local/bin/gendict.exe +0 -0
  48. data/vendor/local/bin/gennorm2.exe +0 -0
  49. data/vendor/local/bin/genrb.exe +0 -0
  50. data/vendor/local/bin/gensprep.exe +0 -0
  51. data/vendor/local/bin/hb-ot-shape-closure.exe +0 -0
  52. data/vendor/local/bin/hb-shape.exe +0 -0
  53. data/vendor/local/bin/hb-view.exe +0 -0
  54. data/vendor/local/bin/icuinfo.exe +0 -0
  55. data/vendor/local/bin/icupkg.exe +0 -0
  56. data/vendor/local/bin/libgraphene-1.0-0.dll +0 -0
  57. data/vendor/local/bin/libharfbuzz-0.dll +0 -0
  58. data/vendor/local/bin/libpango-1.0-0.dll +0 -0
  59. data/vendor/local/bin/libpangocairo-1.0-0.dll +0 -0
  60. data/vendor/local/bin/libpangoft2-1.0-0.dll +0 -0
  61. data/vendor/local/bin/libpangowin32-1.0-0.dll +0 -0
  62. data/vendor/local/bin/makeconv.exe +0 -0
  63. data/vendor/local/bin/pango-view.exe +0 -0
  64. data/vendor/local/bin/pkgdata.exe +0 -0
  65. data/vendor/local/bin/uconv.exe +0 -0
  66. data/vendor/local/include/graphene-1.0/graphene-box.h +148 -0
  67. data/vendor/local/include/graphene-1.0/graphene-euler.h +140 -0
  68. data/vendor/local/include/graphene-1.0/graphene-frustum.h +93 -0
  69. data/vendor/local/include/graphene-1.0/graphene-gobject.h +119 -0
  70. data/vendor/local/include/graphene-1.0/graphene-macros.h +105 -0
  71. data/vendor/local/include/graphene-1.0/graphene-matrix.h +288 -0
  72. data/vendor/local/include/graphene-1.0/graphene-plane.h +99 -0
  73. data/vendor/local/include/graphene-1.0/graphene-point.h +120 -0
  74. data/vendor/local/include/graphene-1.0/graphene-point3d.h +140 -0
  75. data/vendor/local/include/graphene-1.0/graphene-quad.h +80 -0
  76. data/vendor/local/include/graphene-1.0/graphene-quaternion.h +136 -0
  77. data/vendor/local/include/graphene-1.0/graphene-ray.h +98 -0
  78. data/vendor/local/include/graphene-1.0/graphene-rect.h +180 -0
  79. data/vendor/local/include/graphene-1.0/graphene-simd4f.h +1870 -0
  80. data/vendor/local/include/graphene-1.0/graphene-simd4x4f.h +1045 -0
  81. data/vendor/local/include/graphene-1.0/graphene-size.h +105 -0
  82. data/vendor/local/include/graphene-1.0/graphene-sphere.h +97 -0
  83. data/vendor/local/include/graphene-1.0/graphene-triangle.h +105 -0
  84. data/vendor/local/include/graphene-1.0/graphene-types.h +88 -0
  85. data/vendor/local/include/graphene-1.0/graphene-vec2.h +130 -0
  86. data/vendor/local/include/graphene-1.0/graphene-vec3.h +155 -0
  87. data/vendor/local/include/graphene-1.0/graphene-vec4.h +156 -0
  88. data/vendor/local/include/graphene-1.0/graphene-version-macros.h +185 -0
  89. data/vendor/local/include/graphene-1.0/graphene-version.h +70 -0
  90. data/vendor/local/include/graphene-1.0/graphene.h +61 -0
  91. data/vendor/local/include/harfbuzz/hb-common.h +36 -0
  92. data/vendor/local/include/harfbuzz/hb-font.h +18 -1
  93. data/vendor/local/include/harfbuzz/hb-ot-var.h +105 -0
  94. data/vendor/local/include/harfbuzz/hb-ot.h +1 -0
  95. data/vendor/local/include/harfbuzz/hb-shape.h +0 -16
  96. data/vendor/local/include/harfbuzz/hb-version.h +2 -2
  97. data/vendor/local/include/pango-1.0/pango/pango-engine.h +6 -6
  98. data/vendor/local/include/pango-1.0/pango/pango-features.h +2 -2
  99. data/vendor/local/include/pango-1.0/pango/pango-layout.h +1 -1
  100. data/vendor/local/lib/girepository-1.0/Graphene-1.0.typelib +0 -0
  101. data/vendor/local/lib/girepository-1.0/Pango-1.0.typelib +0 -0
  102. data/vendor/local/lib/graphene-1.0/include/graphene-config.h +89 -0
  103. data/vendor/local/lib/icudt.dll +0 -0
  104. data/vendor/local/lib/icudt58.dll +0 -0
  105. data/vendor/local/lib/icuin.dll +0 -0
  106. data/vendor/local/lib/icuin58.dll +0 -0
  107. data/vendor/local/lib/icuio.dll +0 -0
  108. data/vendor/local/lib/icuio58.dll +0 -0
  109. data/vendor/local/lib/icutest.dll +0 -0
  110. data/vendor/local/lib/icutest58.dll +0 -0
  111. data/vendor/local/lib/icutu.dll +0 -0
  112. data/vendor/local/lib/icutu58.dll +0 -0
  113. data/vendor/local/lib/icuuc.dll +0 -0
  114. data/vendor/local/lib/icuuc58.dll +0 -0
  115. data/vendor/local/lib/libgraphene-1.0.dll.a +0 -0
  116. data/vendor/local/lib/libgraphene-1.0.la +41 -0
  117. data/vendor/local/lib/libharfbuzz-icu.a +0 -0
  118. data/vendor/local/lib/libharfbuzz-icu.la +1 -1
  119. data/vendor/local/lib/libharfbuzz.dll.a +0 -0
  120. data/vendor/local/lib/libharfbuzz.la +1 -1
  121. data/vendor/local/lib/libicudt.dll.a +0 -0
  122. data/vendor/local/lib/libicuin.dll.a +0 -0
  123. data/vendor/local/lib/libicuio.dll.a +0 -0
  124. data/vendor/local/lib/libicutest.dll.a +0 -0
  125. data/vendor/local/lib/libicutu.dll.a +0 -0
  126. data/vendor/local/lib/libicuuc.dll.a +0 -0
  127. data/vendor/local/lib/libpango-1.0.dll.a +0 -0
  128. data/vendor/local/lib/libpango-1.0.la +1 -1
  129. data/vendor/local/lib/libpangocairo-1.0.dll.a +0 -0
  130. data/vendor/local/lib/libpangocairo-1.0.la +1 -1
  131. data/vendor/local/lib/libpangoft2-1.0.dll.a +0 -0
  132. data/vendor/local/lib/libpangoft2-1.0.la +1 -1
  133. data/vendor/local/lib/libpangowin32-1.0.dll.a +0 -0
  134. data/vendor/local/lib/libpangowin32-1.0.la +1 -1
  135. data/vendor/local/lib/pkgconfig/graphene-1.0.pc +15 -0
  136. data/vendor/local/lib/pkgconfig/graphene-gobject-1.0.pc +15 -0
  137. data/vendor/local/lib/pkgconfig/harfbuzz-icu.pc +1 -1
  138. data/vendor/local/lib/pkgconfig/harfbuzz.pc +1 -1
  139. data/vendor/local/lib/pkgconfig/pango.pc +1 -1
  140. data/vendor/local/lib/pkgconfig/pangocairo.pc +1 -1
  141. data/vendor/local/lib/pkgconfig/pangoft2.pc +1 -1
  142. data/vendor/local/lib/pkgconfig/pangowin32.pc +1 -1
  143. data/vendor/local/share/gir-1.0/Graphene-1.0.gir +8180 -0
  144. data/vendor/local/share/gir-1.0/Pango-1.0.gir +12 -16
  145. data/vendor/local/share/gtk-doc/html/graphene/annotation-glossary.html +57 -0
  146. data/vendor/local/share/gtk-doc/html/graphene/api-index.html +1985 -0
  147. data/vendor/local/share/gtk-doc/html/graphene/ch01.html +97 -0
  148. data/vendor/local/share/gtk-doc/html/graphene/deprecated-api-index.html +34 -0
  149. data/vendor/local/share/gtk-doc/html/graphene/graphene-Box.html +1252 -0
  150. data/vendor/local/share/gtk-doc/html/graphene/graphene-Euler.html +886 -0
  151. data/vendor/local/share/gtk-doc/html/graphene/graphene-Frustum.html +527 -0
  152. data/vendor/local/share/gtk-doc/html/graphene/graphene-GObject-integration.html +147 -0
  153. data/vendor/local/share/gtk-doc/html/graphene/graphene-Matrix.html +2959 -0
  154. data/vendor/local/share/gtk-doc/html/graphene/graphene-Plane.html +641 -0
  155. data/vendor/local/share/gtk-doc/html/graphene/graphene-Point.html +689 -0
  156. data/vendor/local/share/gtk-doc/html/graphene/graphene-Point3D.html +916 -0
  157. data/vendor/local/share/gtk-doc/html/graphene/graphene-Quad.html +418 -0
  158. data/vendor/local/share/gtk-doc/html/graphene/graphene-Quaternion.html +1056 -0
  159. data/vendor/local/share/gtk-doc/html/graphene/graphene-Ray.html +596 -0
  160. data/vendor/local/share/gtk-doc/html/graphene/graphene-Rectangle.html +1483 -0
  161. data/vendor/local/share/gtk-doc/html/graphene/graphene-SIMD-matrix.html +1475 -0
  162. data/vendor/local/share/gtk-doc/html/graphene/graphene-SIMD-vector.html +3046 -0
  163. data/vendor/local/share/gtk-doc/html/graphene/graphene-Size.html +489 -0
  164. data/vendor/local/share/gtk-doc/html/graphene/graphene-Sphere.html +641 -0
  165. data/vendor/local/share/gtk-doc/html/graphene/graphene-Triangle.html +705 -0
  166. data/vendor/local/share/gtk-doc/html/graphene/graphene-Vectors.html +3715 -0
  167. data/vendor/local/share/gtk-doc/html/graphene/graphene-Versioning-information.html +104 -0
  168. data/vendor/local/share/gtk-doc/html/graphene/graphene.devhelp2 +534 -0
  169. data/vendor/local/share/gtk-doc/html/graphene/home.png +0 -0
  170. data/vendor/local/share/gtk-doc/html/graphene/index.html +107 -0
  171. data/vendor/local/share/gtk-doc/html/graphene/ix03.html +1313 -0
  172. data/vendor/local/share/gtk-doc/html/graphene/ix04.html +582 -0
  173. data/vendor/local/share/gtk-doc/html/graphene/ix05.html +151 -0
  174. data/vendor/local/share/gtk-doc/html/graphene/ix06.html +34 -0
  175. data/vendor/local/share/gtk-doc/html/graphene/left-insensitive.png +0 -0
  176. data/vendor/local/share/gtk-doc/html/graphene/left.png +0 -0
  177. data/vendor/local/share/gtk-doc/html/{pango/api-index-1-40.html → graphene/object-tree.html} +14 -11
  178. data/vendor/local/share/gtk-doc/html/graphene/rectangle-intersection.png +0 -0
  179. data/vendor/local/share/gtk-doc/html/graphene/rectangle-union.png +0 -0
  180. data/vendor/local/share/gtk-doc/html/graphene/rectangle.png +0 -0
  181. data/vendor/local/share/gtk-doc/html/graphene/right-insensitive.png +0 -0
  182. data/vendor/local/share/gtk-doc/html/graphene/right.png +0 -0
  183. data/vendor/local/share/gtk-doc/html/graphene/style.css +479 -0
  184. data/vendor/local/share/gtk-doc/html/graphene/triangle-barycentric.png +0 -0
  185. data/vendor/local/share/gtk-doc/html/graphene/up-insensitive.png +0 -0
  186. data/vendor/local/share/gtk-doc/html/graphene/up.png +0 -0
  187. data/vendor/local/share/gtk-doc/html/harfbuzz/api-index-1-2-3.html +2 -2
  188. data/vendor/local/share/gtk-doc/html/harfbuzz/{api-index-1-4-0.html → api-index-1-3-3.html} +2 -2
  189. data/vendor/local/share/gtk-doc/html/harfbuzz/api-index-full.html +104 -0
  190. data/vendor/local/share/gtk-doc/html/harfbuzz/deprecated-api-index.html +9 -2
  191. data/vendor/local/share/gtk-doc/html/harfbuzz/harfbuzz-Shaping.html +1 -1
  192. data/vendor/local/share/gtk-doc/html/harfbuzz/harfbuzz-hb-font.html +156 -40
  193. data/vendor/local/share/gtk-doc/html/harfbuzz/harfbuzz-hb-gobject.html +73 -0
  194. data/vendor/local/share/gtk-doc/html/harfbuzz/harfbuzz-hb-graphite2.html +1 -0
  195. data/vendor/local/share/gtk-doc/html/harfbuzz/harfbuzz-hb-ot-layout.html +49 -0
  196. data/vendor/local/share/gtk-doc/html/harfbuzz/harfbuzz-hb-ot-math.html +174 -177
  197. data/vendor/local/share/gtk-doc/html/harfbuzz/harfbuzz-hb-shape-plan.html +40 -0
  198. data/vendor/local/share/gtk-doc/html/harfbuzz/harfbuzz-hb-version.html +2 -2
  199. data/vendor/local/share/gtk-doc/html/harfbuzz/harfbuzz.devhelp2 +28 -10
  200. data/vendor/local/share/gtk-doc/html/harfbuzz/index.html +1 -1
  201. data/vendor/local/share/gtk-doc/html/harfbuzz/pt02.html +2 -2
  202. data/vendor/local/share/gtk-doc/html/pango/PangoEngineLang.html +2 -2
  203. data/vendor/local/share/gtk-doc/html/pango/PangoEngineShape.html +2 -2
  204. data/vendor/local/share/gtk-doc/html/pango/PangoFcDecoder.html +1 -1
  205. data/vendor/local/share/gtk-doc/html/pango/PangoFcFont.html +1 -1
  206. data/vendor/local/share/gtk-doc/html/pango/PangoFcFontMap.html +3 -3
  207. data/vendor/local/share/gtk-doc/html/pango/PangoMarkupFormat.html +1 -1
  208. data/vendor/local/share/gtk-doc/html/pango/PangoRenderer.html +2 -2
  209. data/vendor/local/share/gtk-doc/html/pango/annotation-glossary.html +1 -1
  210. data/vendor/local/share/gtk-doc/html/pango/api-index-full.html +1 -1
  211. data/vendor/local/share/gtk-doc/html/pango/index.html +2 -23
  212. data/vendor/local/share/gtk-doc/html/pango/lowlevel.html +1 -1
  213. data/vendor/local/share/gtk-doc/html/pango/pango-Bidirectional-Text.html +1 -1
  214. data/vendor/local/share/gtk-doc/html/pango/pango-Cairo-Rendering.html +69 -69
  215. data/vendor/local/share/gtk-doc/html/pango/pango-CoreText-Fonts.html +1 -1
  216. data/vendor/local/share/gtk-doc/html/pango/pango-Coverage-Maps.html +1 -1
  217. data/vendor/local/share/gtk-doc/html/pango/pango-Engines.html +5 -1
  218. data/vendor/local/share/gtk-doc/html/pango/pango-Fonts.html +5 -4
  219. data/vendor/local/share/gtk-doc/html/pango/pango-FreeType-Fonts-and-Rendering.html +8 -4
  220. data/vendor/local/share/gtk-doc/html/pango/pango-Glyph-Storage.html +3 -3
  221. data/vendor/local/share/gtk-doc/html/pango/pango-Layout-Objects.html +4 -4
  222. data/vendor/local/share/gtk-doc/html/pango/pango-Miscellaneous-Utilities.html +1 -1
  223. data/vendor/local/share/gtk-doc/html/pango/pango-Modules.html +3 -1
  224. data/vendor/local/share/gtk-doc/html/pango/pango-OpenType-Font-Handling.html +1 -1
  225. data/vendor/local/share/gtk-doc/html/pango/pango-Scripts-and-Languages.html +3 -3
  226. data/vendor/local/share/gtk-doc/html/pango/pango-Tab-Stops.html +1 -1
  227. data/vendor/local/share/gtk-doc/html/pango/pango-Text-Attributes.html +1 -1
  228. data/vendor/local/share/gtk-doc/html/pango/pango-Text-Processing.html +3 -3
  229. data/vendor/local/share/gtk-doc/html/pango/pango-Version-Checking.html +3 -3
  230. data/vendor/local/share/gtk-doc/html/pango/pango-Vertical-Text.html +1 -1
  231. data/vendor/local/share/gtk-doc/html/pango/pango-Win32-Fonts-and-Rendering.html +3 -3
  232. data/vendor/local/share/gtk-doc/html/pango/pango-Xft-Fonts-and-Rendering.html +1 -1
  233. data/vendor/local/share/gtk-doc/html/pango/pango-hierarchy.html +1 -1
  234. data/vendor/local/share/gtk-doc/html/pango/pango.html +1 -1
  235. data/vendor/local/share/gtk-doc/html/pango/rendering.html +1 -1
  236. data/vendor/local/share/man/man1/pango-view.1 +2 -2
  237. metadata +119 -78
  238. data/README +0 -32
  239. data/ext/pango/rbpango.c +0 -356
  240. data/ext/pango/rbpango.h +0 -95
  241. data/ext/pango/rbpangoanalysis.c +0 -218
  242. data/ext/pango/rbpangoattribute.c +0 -506
  243. data/ext/pango/rbpangoattriterator.c +0 -141
  244. data/ext/pango/rbpangoattrlist.c +0 -101
  245. data/ext/pango/rbpangocairo.c +0 -122
  246. data/ext/pango/rbpangocairocontext.c +0 -131
  247. data/ext/pango/rbpangocolor.c +0 -120
  248. data/ext/pango/rbpangocontext.c +0 -344
  249. data/ext/pango/rbpangocoverage.c +0 -106
  250. data/ext/pango/rbpangoengine.c +0 -73
  251. data/ext/pango/rbpangofont.c +0 -110
  252. data/ext/pango/rbpangofontdescription.c +0 -282
  253. data/ext/pango/rbpangofontface.c +0 -73
  254. data/ext/pango/rbpangofontfamily.c +0 -79
  255. data/ext/pango/rbpangofontmap.c +0 -102
  256. data/ext/pango/rbpangofontmetrics.c +0 -85
  257. data/ext/pango/rbpangofontset.c +0 -69
  258. data/ext/pango/rbpangofontsetsimple.c +0 -60
  259. data/ext/pango/rbpangoglyphinfo.c +0 -123
  260. data/ext/pango/rbpangoglyphitem.c +0 -125
  261. data/ext/pango/rbpangoglyphstring.c +0 -151
  262. data/ext/pango/rbpangogravity.c +0 -54
  263. data/ext/pango/rbpangoitem.c +0 -95
  264. data/ext/pango/rbpangolanguage.c +0 -94
  265. data/ext/pango/rbpangolayout.c +0 -583
  266. data/ext/pango/rbpangolayoutiter.c +0 -189
  267. data/ext/pango/rbpangolayoutline.c +0 -243
  268. data/ext/pango/rbpangologattr.c +0 -109
  269. data/ext/pango/rbpangomatrix.c +0 -143
  270. data/ext/pango/rbpangoprivate.h +0 -49
  271. data/ext/pango/rbpangorectangle.c +0 -170
  272. data/ext/pango/rbpangorenderer.c +0 -193
  273. data/ext/pango/rbpangoscript.c +0 -84
  274. data/ext/pango/rbpangoscriptiter.c +0 -92
  275. data/ext/pango/rbpangotabarray.c +0 -128
  276. data/sample/attribute.rb +0 -82
  277. data/sample/break.rb +0 -28
  278. data/sample/gdk_layout.rb +0 -27
  279. data/sample/glyphstring.rb +0 -61
  280. data/sample/item.rb +0 -37
  281. data/sample/label.rb +0 -23
  282. data/sample/layout.rb +0 -102
  283. data/sample/pango_cairo.rb +0 -66
  284. data/sample/parse.rb +0 -33
  285. data/sample/sample.txt +0 -10
  286. data/sample/script.rb +0 -23
  287. data/vendor/local/share/gtk-doc/html/pango/api-index-1-10.html +0 -134
  288. data/vendor/local/share/gtk-doc/html/pango/api-index-1-12.html +0 -48
  289. data/vendor/local/share/gtk-doc/html/pango/api-index-1-14.html +0 -63
  290. data/vendor/local/share/gtk-doc/html/pango/api-index-1-16.html +0 -227
  291. data/vendor/local/share/gtk-doc/html/pango/api-index-1-18.html +0 -151
  292. data/vendor/local/share/gtk-doc/html/pango/api-index-1-2.html +0 -121
  293. data/vendor/local/share/gtk-doc/html/pango/api-index-1-20.html +0 -86
  294. data/vendor/local/share/gtk-doc/html/pango/api-index-1-22.html +0 -123
  295. data/vendor/local/share/gtk-doc/html/pango/api-index-1-24.html +0 -96
  296. data/vendor/local/share/gtk-doc/html/pango/api-index-1-26.html +0 -45
  297. data/vendor/local/share/gtk-doc/html/pango/api-index-1-30.html +0 -38
  298. data/vendor/local/share/gtk-doc/html/pango/api-index-1-31-0.html +0 -38
  299. data/vendor/local/share/gtk-doc/html/pango/api-index-1-32-4.html +0 -52
  300. data/vendor/local/share/gtk-doc/html/pango/api-index-1-32.html +0 -41
  301. data/vendor/local/share/gtk-doc/html/pango/api-index-1-34.html +0 -38
  302. data/vendor/local/share/gtk-doc/html/pango/api-index-1-38.html +0 -79
  303. data/vendor/local/share/gtk-doc/html/pango/api-index-1-4.html +0 -200
  304. data/vendor/local/share/gtk-doc/html/pango/api-index-1-6.html +0 -164
  305. data/vendor/local/share/gtk-doc/html/pango/api-index-1-8.html +0 -170
  306. data/vendor/local/share/gtk-doc/html/pango/api-index-deprecated.html +0 -441
@@ -0,0 +1,418 @@
1
+ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
+ <html>
3
+ <head>
4
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
+ <title>Quad: Graphene Reference Manual</title>
6
+ <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
7
+ <link rel="home" href="index.html" title="Graphene Reference Manual">
8
+ <link rel="up" href="ch01.html" title="Graphene">
9
+ <link rel="prev" href="graphene-Rectangle.html" title="Rectangle">
10
+ <link rel="next" href="graphene-Triangle.html" title="Triangle">
11
+ <meta name="generator" content="GTK-Doc V1.25 (XML mode)">
12
+ <link rel="stylesheet" href="style.css" type="text/css">
13
+ </head>
14
+ <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
+ <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
16
+ <td width="100%" align="left" class="shortcuts">
17
+ <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
18
+ <a href="#graphene-Quad.description" class="shortcut">Description</a></span>
19
+ </td>
20
+ <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
21
+ <td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
22
+ <td><a accesskey="p" href="graphene-Rectangle.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
23
+ <td><a accesskey="n" href="graphene-Triangle.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
24
+ </tr></table>
25
+ <div class="refentry">
26
+ <a name="graphene-Quad"></a><div class="titlepage"></div>
27
+ <div class="refnamediv"><table width="100%"><tr>
28
+ <td valign="top">
29
+ <h2><span class="refentrytitle"><a name="graphene-Quad.top_of_page"></a>Quad</span></h2>
30
+ <p>Quad — Four-vertex quadrilateral</p>
31
+ </td>
32
+ <td class="gallery_image" valign="top" align="right"></td>
33
+ </tr></table></div>
34
+ <div class="refsect1">
35
+ <a name="graphene-Quad.functions"></a><h2>Functions</h2>
36
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
37
+ <colgroup>
38
+ <col width="150px" class="functions_return">
39
+ <col class="functions_name">
40
+ </colgroup>
41
+ <tbody>
42
+ <tr>
43
+ <td class="function_type">
44
+ <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="returnvalue">graphene_quad_t</span></a> *
45
+ </td>
46
+ <td class="function_name">
47
+ <a class="link" href="graphene-Quad.html#graphene-quad-alloc" title="graphene_quad_alloc ()">graphene_quad_alloc</a> <span class="c_punctuation">()</span>
48
+ </td>
49
+ </tr>
50
+ <tr>
51
+ <td class="function_type">
52
+ <span class="returnvalue">void</span>
53
+ </td>
54
+ <td class="function_name">
55
+ <a class="link" href="graphene-Quad.html#graphene-quad-free" title="graphene_quad_free ()">graphene_quad_free</a> <span class="c_punctuation">()</span>
56
+ </td>
57
+ </tr>
58
+ <tr>
59
+ <td class="function_type">
60
+ <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="returnvalue">graphene_quad_t</span></a> *
61
+ </td>
62
+ <td class="function_name">
63
+ <a class="link" href="graphene-Quad.html#graphene-quad-init" title="graphene_quad_init ()">graphene_quad_init</a> <span class="c_punctuation">()</span>
64
+ </td>
65
+ </tr>
66
+ <tr>
67
+ <td class="function_type">
68
+ <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="returnvalue">graphene_quad_t</span></a> *
69
+ </td>
70
+ <td class="function_name">
71
+ <a class="link" href="graphene-Quad.html#graphene-quad-init-from-rect" title="graphene_quad_init_from_rect ()">graphene_quad_init_from_rect</a> <span class="c_punctuation">()</span>
72
+ </td>
73
+ </tr>
74
+ <tr>
75
+ <td class="function_type">
76
+ <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="returnvalue">graphene_quad_t</span></a> *
77
+ </td>
78
+ <td class="function_name">
79
+ <a class="link" href="graphene-Quad.html#graphene-quad-init-from-points" title="graphene_quad_init_from_points ()">graphene_quad_init_from_points</a> <span class="c_punctuation">()</span>
80
+ </td>
81
+ </tr>
82
+ <tr>
83
+ <td class="function_type">
84
+ <span class="returnvalue">bool</span>
85
+ </td>
86
+ <td class="function_name">
87
+ <a class="link" href="graphene-Quad.html#graphene-quad-contains" title="graphene_quad_contains ()">graphene_quad_contains</a> <span class="c_punctuation">()</span>
88
+ </td>
89
+ </tr>
90
+ <tr>
91
+ <td class="function_type">
92
+ <span class="returnvalue">void</span>
93
+ </td>
94
+ <td class="function_name">
95
+ <a class="link" href="graphene-Quad.html#graphene-quad-bounds" title="graphene_quad_bounds ()">graphene_quad_bounds</a> <span class="c_punctuation">()</span>
96
+ </td>
97
+ </tr>
98
+ <tr>
99
+ <td class="function_type">const <a class="link" href="graphene-Point.html#graphene-point-t" title="graphene_point_t"><span class="returnvalue">graphene_point_t</span></a> *
100
+ </td>
101
+ <td class="function_name">
102
+ <a class="link" href="graphene-Quad.html#graphene-quad-get-point" title="graphene_quad_get_point ()">graphene_quad_get_point</a> <span class="c_punctuation">()</span>
103
+ </td>
104
+ </tr>
105
+ </tbody>
106
+ </table></div>
107
+ </div>
108
+ <div class="refsect1">
109
+ <a name="graphene-Quad.other"></a><h2>Types and Values</h2>
110
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
111
+ <colgroup>
112
+ <col width="150px" class="name">
113
+ <col class="description">
114
+ </colgroup>
115
+ <tbody><tr>
116
+ <td class="datatype_keyword"> </td>
117
+ <td class="function_name"><a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t">graphene_quad_t</a></td>
118
+ </tr></tbody>
119
+ </table></div>
120
+ </div>
121
+ <div class="refsect1">
122
+ <a name="graphene-Quad.includes"></a><h2>Includes</h2>
123
+ <pre class="synopsis">#include &lt;graphene.h&gt;
124
+ </pre>
125
+ </div>
126
+ <div class="refsect1">
127
+ <a name="graphene-Quad.description"></a><h2>Description</h2>
128
+ <p>A <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a> represents a coplanar, four vertex quadrilateral shape.</p>
129
+ </div>
130
+ <div class="refsect1">
131
+ <a name="graphene-Quad.functions_details"></a><h2>Functions</h2>
132
+ <div class="refsect2">
133
+ <a name="graphene-quad-alloc"></a><h3>graphene_quad_alloc ()</h3>
134
+ <pre class="programlisting"><a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="returnvalue">graphene_quad_t</span></a> *
135
+ graphene_quad_alloc (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
136
+ <p>Allocates a new <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a> instance.</p>
137
+ <p>The contents of the returned instance are undefined.</p>
138
+ <p><span class="annotation">[<acronym title="This symbol is a constructor, not a static method."><span class="acronym">constructor</span></acronym>]</span></p>
139
+ <div class="refsect3">
140
+ <a name="graphene-quad-alloc.returns"></a><h4>Returns</h4>
141
+ <p> the newly created <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a> instance. </p>
142
+ <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
143
+ </div>
144
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
145
+ </div>
146
+ <hr>
147
+ <div class="refsect2">
148
+ <a name="graphene-quad-free"></a><h3>graphene_quad_free ()</h3>
149
+ <pre class="programlisting"><span class="returnvalue">void</span>
150
+ graphene_quad_free (<em class="parameter"><code><a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a> *q</code></em>);</pre>
151
+ <p>Frees the resources allocated by <a class="link" href="graphene-Quad.html#graphene-quad-alloc" title="graphene_quad_alloc ()"><code class="function">graphene_quad_alloc()</code></a></p>
152
+ <div class="refsect3">
153
+ <a name="graphene-quad-free.parameters"></a><h4>Parameters</h4>
154
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
155
+ <colgroup>
156
+ <col width="150px" class="parameters_name">
157
+ <col class="parameters_description">
158
+ <col width="200px" class="parameters_annotations">
159
+ </colgroup>
160
+ <tbody><tr>
161
+ <td class="parameter_name"><p>q</p></td>
162
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a></p></td>
163
+ <td class="parameter_annotations"> </td>
164
+ </tr></tbody>
165
+ </table></div>
166
+ </div>
167
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
168
+ </div>
169
+ <hr>
170
+ <div class="refsect2">
171
+ <a name="graphene-quad-init"></a><h3>graphene_quad_init ()</h3>
172
+ <pre class="programlisting"><a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="returnvalue">graphene_quad_t</span></a> *
173
+ graphene_quad_init (<em class="parameter"><code><a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a> *q</code></em>,
174
+ <em class="parameter"><code>const <a class="link" href="graphene-Point.html#graphene-point-t" title="graphene_point_t"><span class="type">graphene_point_t</span></a> *p1</code></em>,
175
+ <em class="parameter"><code>const <a class="link" href="graphene-Point.html#graphene-point-t" title="graphene_point_t"><span class="type">graphene_point_t</span></a> *p2</code></em>,
176
+ <em class="parameter"><code>const <a class="link" href="graphene-Point.html#graphene-point-t" title="graphene_point_t"><span class="type">graphene_point_t</span></a> *p3</code></em>,
177
+ <em class="parameter"><code>const <a class="link" href="graphene-Point.html#graphene-point-t" title="graphene_point_t"><span class="type">graphene_point_t</span></a> *p4</code></em>);</pre>
178
+ <p>Initializes a <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a> with the given points.</p>
179
+ <div class="refsect3">
180
+ <a name="graphene-quad-init.parameters"></a><h4>Parameters</h4>
181
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
182
+ <colgroup>
183
+ <col width="150px" class="parameters_name">
184
+ <col class="parameters_description">
185
+ <col width="200px" class="parameters_annotations">
186
+ </colgroup>
187
+ <tbody>
188
+ <tr>
189
+ <td class="parameter_name"><p>q</p></td>
190
+ <td class="parameter_description"><p>the <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a> to initialize</p></td>
191
+ <td class="parameter_annotations"> </td>
192
+ </tr>
193
+ <tr>
194
+ <td class="parameter_name"><p>p1</p></td>
195
+ <td class="parameter_description"><p>the first point of the quadrilateral</p></td>
196
+ <td class="parameter_annotations"> </td>
197
+ </tr>
198
+ <tr>
199
+ <td class="parameter_name"><p>p2</p></td>
200
+ <td class="parameter_description"><p>the second point of the quadrilateral</p></td>
201
+ <td class="parameter_annotations"> </td>
202
+ </tr>
203
+ <tr>
204
+ <td class="parameter_name"><p>p3</p></td>
205
+ <td class="parameter_description"><p>the third point of the quadrilateral</p></td>
206
+ <td class="parameter_annotations"> </td>
207
+ </tr>
208
+ <tr>
209
+ <td class="parameter_name"><p>p4</p></td>
210
+ <td class="parameter_description"><p>the fourth point of the quadrilateral</p></td>
211
+ <td class="parameter_annotations"> </td>
212
+ </tr>
213
+ </tbody>
214
+ </table></div>
215
+ </div>
216
+ <div class="refsect3">
217
+ <a name="graphene-quad-init.returns"></a><h4>Returns</h4>
218
+ <p> the initialized <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a>. </p>
219
+ <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
220
+ </div>
221
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
222
+ </div>
223
+ <hr>
224
+ <div class="refsect2">
225
+ <a name="graphene-quad-init-from-rect"></a><h3>graphene_quad_init_from_rect ()</h3>
226
+ <pre class="programlisting"><a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="returnvalue">graphene_quad_t</span></a> *
227
+ graphene_quad_init_from_rect (<em class="parameter"><code><a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a> *q</code></em>,
228
+ <em class="parameter"><code>const <a class="link" href="graphene-Rectangle.html#graphene-rect-t" title="graphene_rect_t"><span class="type">graphene_rect_t</span></a> *r</code></em>);</pre>
229
+ <p>Initializes a <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a> using the four corners of the
230
+ given <a class="link" href="graphene-Rectangle.html#graphene-rect-t" title="graphene_rect_t"><span class="type">graphene_rect_t</span></a>.</p>
231
+ <div class="refsect3">
232
+ <a name="graphene-quad-init-from-rect.parameters"></a><h4>Parameters</h4>
233
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
234
+ <colgroup>
235
+ <col width="150px" class="parameters_name">
236
+ <col class="parameters_description">
237
+ <col width="200px" class="parameters_annotations">
238
+ </colgroup>
239
+ <tbody>
240
+ <tr>
241
+ <td class="parameter_name"><p>q</p></td>
242
+ <td class="parameter_description"><p>the <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a> to initialize</p></td>
243
+ <td class="parameter_annotations"> </td>
244
+ </tr>
245
+ <tr>
246
+ <td class="parameter_name"><p>r</p></td>
247
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Rectangle.html#graphene-rect-t" title="graphene_rect_t"><span class="type">graphene_rect_t</span></a></p></td>
248
+ <td class="parameter_annotations"> </td>
249
+ </tr>
250
+ </tbody>
251
+ </table></div>
252
+ </div>
253
+ <div class="refsect3">
254
+ <a name="graphene-quad-init-from-rect.returns"></a><h4>Returns</h4>
255
+ <p> the initialized <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a>. </p>
256
+ <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
257
+ </div>
258
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
259
+ </div>
260
+ <hr>
261
+ <div class="refsect2">
262
+ <a name="graphene-quad-init-from-points"></a><h3>graphene_quad_init_from_points ()</h3>
263
+ <pre class="programlisting"><a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="returnvalue">graphene_quad_t</span></a> *
264
+ graphene_quad_init_from_points (<em class="parameter"><code><a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a> *q</code></em>,
265
+ <em class="parameter"><code>const <a class="link" href="graphene-Point.html#graphene-point-t" title="graphene_point_t"><span class="type">graphene_point_t</span></a> points[]</code></em>);</pre>
266
+ <p>Initializes a <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a> using an array of points.</p>
267
+ <div class="refsect3">
268
+ <a name="graphene-quad-init-from-points.parameters"></a><h4>Parameters</h4>
269
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
270
+ <colgroup>
271
+ <col width="150px" class="parameters_name">
272
+ <col class="parameters_description">
273
+ <col width="200px" class="parameters_annotations">
274
+ </colgroup>
275
+ <tbody>
276
+ <tr>
277
+ <td class="parameter_name"><p>q</p></td>
278
+ <td class="parameter_description"><p>the <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a> to initialize</p></td>
279
+ <td class="parameter_annotations"> </td>
280
+ </tr>
281
+ <tr>
282
+ <td class="parameter_name"><p>points</p></td>
283
+ <td class="parameter_description"><p> an array of 4 <a class="link" href="graphene-Point.html#graphene-point-t" title="graphene_point_t"><span class="type">graphene_point_t</span></a>. </p></td>
284
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> fixed-size=4]</span></td>
285
+ </tr>
286
+ </tbody>
287
+ </table></div>
288
+ </div>
289
+ <div class="refsect3">
290
+ <a name="graphene-quad-init-from-points.returns"></a><h4>Returns</h4>
291
+ <p> the initialized <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a>. </p>
292
+ <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
293
+ </div>
294
+ <p class="since">Since: <a class="link" href="ix04.html#api-index-1.2">1.2</a></p>
295
+ </div>
296
+ <hr>
297
+ <div class="refsect2">
298
+ <a name="graphene-quad-contains"></a><h3>graphene_quad_contains ()</h3>
299
+ <pre class="programlisting"><span class="returnvalue">bool</span>
300
+ graphene_quad_contains (<em class="parameter"><code>const <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a> *q</code></em>,
301
+ <em class="parameter"><code>const <a class="link" href="graphene-Point.html#graphene-point-t" title="graphene_point_t"><span class="type">graphene_point_t</span></a> *p</code></em>);</pre>
302
+ <p>Checks if the given <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a> contains the given <a class="link" href="graphene-Point.html#graphene-point-t" title="graphene_point_t"><span class="type">graphene_point_t</span></a>.</p>
303
+ <div class="refsect3">
304
+ <a name="graphene-quad-contains.parameters"></a><h4>Parameters</h4>
305
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
306
+ <colgroup>
307
+ <col width="150px" class="parameters_name">
308
+ <col class="parameters_description">
309
+ <col width="200px" class="parameters_annotations">
310
+ </colgroup>
311
+ <tbody>
312
+ <tr>
313
+ <td class="parameter_name"><p>q</p></td>
314
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a></p></td>
315
+ <td class="parameter_annotations"> </td>
316
+ </tr>
317
+ <tr>
318
+ <td class="parameter_name"><p>p</p></td>
319
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Point.html#graphene-point-t" title="graphene_point_t"><span class="type">graphene_point_t</span></a></p></td>
320
+ <td class="parameter_annotations"> </td>
321
+ </tr>
322
+ </tbody>
323
+ </table></div>
324
+ </div>
325
+ <div class="refsect3">
326
+ <a name="graphene-quad-contains.returns"></a><h4>Returns</h4>
327
+ <p> <code class="literal">true</code> if the point is inside the <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a></p>
328
+ </div>
329
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
330
+ </div>
331
+ <hr>
332
+ <div class="refsect2">
333
+ <a name="graphene-quad-bounds"></a><h3>graphene_quad_bounds ()</h3>
334
+ <pre class="programlisting"><span class="returnvalue">void</span>
335
+ graphene_quad_bounds (<em class="parameter"><code>const <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a> *q</code></em>,
336
+ <em class="parameter"><code><a class="link" href="graphene-Rectangle.html#graphene-rect-t" title="graphene_rect_t"><span class="type">graphene_rect_t</span></a> *r</code></em>);</pre>
337
+ <p>Computes the bounding rectangle of <em class="parameter"><code>q</code></em>
338
+ and places it into <em class="parameter"><code>r</code></em>
339
+ .</p>
340
+ <div class="refsect3">
341
+ <a name="graphene-quad-bounds.parameters"></a><h4>Parameters</h4>
342
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
343
+ <colgroup>
344
+ <col width="150px" class="parameters_name">
345
+ <col class="parameters_description">
346
+ <col width="200px" class="parameters_annotations">
347
+ </colgroup>
348
+ <tbody>
349
+ <tr>
350
+ <td class="parameter_name"><p>q</p></td>
351
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a></p></td>
352
+ <td class="parameter_annotations"> </td>
353
+ </tr>
354
+ <tr>
355
+ <td class="parameter_name"><p>r</p></td>
356
+ <td class="parameter_description"><p> return location for a <a class="link" href="graphene-Rectangle.html#graphene-rect-t" title="graphene_rect_t"><span class="type">graphene_rect_t</span></a>. </p></td>
357
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out caller-allocates</span></acronym>]</span></td>
358
+ </tr>
359
+ </tbody>
360
+ </table></div>
361
+ </div>
362
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
363
+ </div>
364
+ <hr>
365
+ <div class="refsect2">
366
+ <a name="graphene-quad-get-point"></a><h3>graphene_quad_get_point ()</h3>
367
+ <pre class="programlisting">const <a class="link" href="graphene-Point.html#graphene-point-t" title="graphene_point_t"><span class="returnvalue">graphene_point_t</span></a> *
368
+ graphene_quad_get_point (<em class="parameter"><code>const <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a> *q</code></em>,
369
+ <em class="parameter"><code>unsigned <span class="type">int</span> index_</code></em>);</pre>
370
+ <p>Retrieves the point of a <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a> at the given index.</p>
371
+ <div class="refsect3">
372
+ <a name="graphene-quad-get-point.parameters"></a><h4>Parameters</h4>
373
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
374
+ <colgroup>
375
+ <col width="150px" class="parameters_name">
376
+ <col class="parameters_description">
377
+ <col width="200px" class="parameters_annotations">
378
+ </colgroup>
379
+ <tbody>
380
+ <tr>
381
+ <td class="parameter_name"><p>q</p></td>
382
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a></p></td>
383
+ <td class="parameter_annotations"> </td>
384
+ </tr>
385
+ <tr>
386
+ <td class="parameter_name"><p>index_</p></td>
387
+ <td class="parameter_description"><p>the index of the point to retrieve</p></td>
388
+ <td class="parameter_annotations"> </td>
389
+ </tr>
390
+ </tbody>
391
+ </table></div>
392
+ </div>
393
+ <div class="refsect3">
394
+ <a name="graphene-quad-get-point.returns"></a><h4>Returns</h4>
395
+ <p> a <a class="link" href="graphene-Point.html#graphene-point-t" title="graphene_point_t"><span class="type">graphene_point_t</span></a>. </p>
396
+ <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
397
+ </div>
398
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
399
+ </div>
400
+ </div>
401
+ <div class="refsect1">
402
+ <a name="graphene-Quad.other_details"></a><h2>Types and Values</h2>
403
+ <div class="refsect2">
404
+ <a name="graphene-quad-t"></a><h3>graphene_quad_t</h3>
405
+ <pre class="programlisting">typedef struct {
406
+ } graphene_quad_t;
407
+ </pre>
408
+ <p>A 4 vertex quadrilateral, as represented by four <a class="link" href="graphene-Point.html#graphene-point-t" title="graphene_point_t"><span class="type">graphene_point_t</span></a>.</p>
409
+ <p>The contents of a <a class="link" href="graphene-Quad.html#graphene-quad-t" title="graphene_quad_t"><span class="type">graphene_quad_t</span></a> are private and should never be
410
+ accessed directly.</p>
411
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
412
+ </div>
413
+ </div>
414
+ </div>
415
+ <div class="footer">
416
+ <hr>Generated by GTK-Doc V1.25</div>
417
+ </body>
418
+ </html>
@@ -0,0 +1,1056 @@
1
+ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
+ <html>
3
+ <head>
4
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
+ <title>Quaternion: Graphene Reference Manual</title>
6
+ <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
7
+ <link rel="home" href="index.html" title="Graphene Reference Manual">
8
+ <link rel="up" href="ch01.html" title="Graphene">
9
+ <link rel="prev" href="graphene-Euler.html" title="Euler">
10
+ <link rel="next" href="graphene-Plane.html" title="Plane">
11
+ <meta name="generator" content="GTK-Doc V1.25 (XML mode)">
12
+ <link rel="stylesheet" href="style.css" type="text/css">
13
+ </head>
14
+ <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
+ <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
16
+ <td width="100%" align="left" class="shortcuts">
17
+ <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
18
+ <a href="#graphene-Quaternion.description" class="shortcut">Description</a></span>
19
+ </td>
20
+ <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
21
+ <td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
22
+ <td><a accesskey="p" href="graphene-Euler.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
23
+ <td><a accesskey="n" href="graphene-Plane.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
24
+ </tr></table>
25
+ <div class="refentry">
26
+ <a name="graphene-Quaternion"></a><div class="titlepage"></div>
27
+ <div class="refnamediv"><table width="100%"><tr>
28
+ <td valign="top">
29
+ <h2><span class="refentrytitle"><a name="graphene-Quaternion.top_of_page"></a>Quaternion</span></h2>
30
+ <p>Quaternion — Quaternion operations</p>
31
+ </td>
32
+ <td class="gallery_image" valign="top" align="right"></td>
33
+ </tr></table></div>
34
+ <div class="refsect1">
35
+ <a name="graphene-Quaternion.functions"></a><h2>Functions</h2>
36
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
37
+ <colgroup>
38
+ <col width="150px" class="functions_return">
39
+ <col class="functions_name">
40
+ </colgroup>
41
+ <tbody>
42
+ <tr>
43
+ <td class="function_type">
44
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="returnvalue">graphene_quaternion_t</span></a> *
45
+ </td>
46
+ <td class="function_name">
47
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-alloc" title="graphene_quaternion_alloc ()">graphene_quaternion_alloc</a> <span class="c_punctuation">()</span>
48
+ </td>
49
+ </tr>
50
+ <tr>
51
+ <td class="function_type">
52
+ <span class="returnvalue">void</span>
53
+ </td>
54
+ <td class="function_name">
55
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-free" title="graphene_quaternion_free ()">graphene_quaternion_free</a> <span class="c_punctuation">()</span>
56
+ </td>
57
+ </tr>
58
+ <tr>
59
+ <td class="function_type">
60
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="returnvalue">graphene_quaternion_t</span></a> *
61
+ </td>
62
+ <td class="function_name">
63
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-init" title="graphene_quaternion_init ()">graphene_quaternion_init</a> <span class="c_punctuation">()</span>
64
+ </td>
65
+ </tr>
66
+ <tr>
67
+ <td class="function_type">
68
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="returnvalue">graphene_quaternion_t</span></a> *
69
+ </td>
70
+ <td class="function_name">
71
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-init-identity" title="graphene_quaternion_init_identity ()">graphene_quaternion_init_identity</a> <span class="c_punctuation">()</span>
72
+ </td>
73
+ </tr>
74
+ <tr>
75
+ <td class="function_type">
76
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="returnvalue">graphene_quaternion_t</span></a> *
77
+ </td>
78
+ <td class="function_name">
79
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-init-from-quaternion" title="graphene_quaternion_init_from_quaternion ()">graphene_quaternion_init_from_quaternion</a> <span class="c_punctuation">()</span>
80
+ </td>
81
+ </tr>
82
+ <tr>
83
+ <td class="function_type">
84
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="returnvalue">graphene_quaternion_t</span></a> *
85
+ </td>
86
+ <td class="function_name">
87
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-init-from-vec4" title="graphene_quaternion_init_from_vec4 ()">graphene_quaternion_init_from_vec4</a> <span class="c_punctuation">()</span>
88
+ </td>
89
+ </tr>
90
+ <tr>
91
+ <td class="function_type">
92
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="returnvalue">graphene_quaternion_t</span></a> *
93
+ </td>
94
+ <td class="function_name">
95
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-init-from-matrix" title="graphene_quaternion_init_from_matrix ()">graphene_quaternion_init_from_matrix</a> <span class="c_punctuation">()</span>
96
+ </td>
97
+ </tr>
98
+ <tr>
99
+ <td class="function_type">
100
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="returnvalue">graphene_quaternion_t</span></a> *
101
+ </td>
102
+ <td class="function_name">
103
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-init-from-angles" title="graphene_quaternion_init_from_angles ()">graphene_quaternion_init_from_angles</a> <span class="c_punctuation">()</span>
104
+ </td>
105
+ </tr>
106
+ <tr>
107
+ <td class="function_type">
108
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="returnvalue">graphene_quaternion_t</span></a> *
109
+ </td>
110
+ <td class="function_name">
111
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-init-from-radians" title="graphene_quaternion_init_from_radians ()">graphene_quaternion_init_from_radians</a> <span class="c_punctuation">()</span>
112
+ </td>
113
+ </tr>
114
+ <tr>
115
+ <td class="function_type">
116
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="returnvalue">graphene_quaternion_t</span></a> *
117
+ </td>
118
+ <td class="function_name">
119
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-init-from-angle-vec3" title="graphene_quaternion_init_from_angle_vec3 ()">graphene_quaternion_init_from_angle_vec3</a> <span class="c_punctuation">()</span>
120
+ </td>
121
+ </tr>
122
+ <tr>
123
+ <td class="function_type">
124
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="returnvalue">graphene_quaternion_t</span></a> *
125
+ </td>
126
+ <td class="function_name">
127
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-init-from-euler" title="graphene_quaternion_init_from_euler ()">graphene_quaternion_init_from_euler</a> <span class="c_punctuation">()</span>
128
+ </td>
129
+ </tr>
130
+ <tr>
131
+ <td class="function_type">
132
+ <span class="returnvalue">void</span>
133
+ </td>
134
+ <td class="function_name">
135
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-to-vec4" title="graphene_quaternion_to_vec4 ()">graphene_quaternion_to_vec4</a> <span class="c_punctuation">()</span>
136
+ </td>
137
+ </tr>
138
+ <tr>
139
+ <td class="function_type">
140
+ <span class="returnvalue">void</span>
141
+ </td>
142
+ <td class="function_name">
143
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-to-matrix" title="graphene_quaternion_to_matrix ()">graphene_quaternion_to_matrix</a> <span class="c_punctuation">()</span>
144
+ </td>
145
+ </tr>
146
+ <tr>
147
+ <td class="function_type">
148
+ <span class="returnvalue">void</span>
149
+ </td>
150
+ <td class="function_name">
151
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-to-angles" title="graphene_quaternion_to_angles ()">graphene_quaternion_to_angles</a> <span class="c_punctuation">()</span>
152
+ </td>
153
+ </tr>
154
+ <tr>
155
+ <td class="function_type">
156
+ <span class="returnvalue">void</span>
157
+ </td>
158
+ <td class="function_name">
159
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-to-radians" title="graphene_quaternion_to_radians ()">graphene_quaternion_to_radians</a> <span class="c_punctuation">()</span>
160
+ </td>
161
+ </tr>
162
+ <tr>
163
+ <td class="function_type">
164
+ <span class="returnvalue">void</span>
165
+ </td>
166
+ <td class="function_name">
167
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-to-angle-vec3" title="graphene_quaternion_to_angle_vec3 ()">graphene_quaternion_to_angle_vec3</a> <span class="c_punctuation">()</span>
168
+ </td>
169
+ </tr>
170
+ <tr>
171
+ <td class="function_type">
172
+ <span class="returnvalue">bool</span>
173
+ </td>
174
+ <td class="function_name">
175
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-equal" title="graphene_quaternion_equal ()">graphene_quaternion_equal</a> <span class="c_punctuation">()</span>
176
+ </td>
177
+ </tr>
178
+ <tr>
179
+ <td class="function_type">
180
+ <span class="returnvalue">float</span>
181
+ </td>
182
+ <td class="function_name">
183
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-dot" title="graphene_quaternion_dot ()">graphene_quaternion_dot</a> <span class="c_punctuation">()</span>
184
+ </td>
185
+ </tr>
186
+ <tr>
187
+ <td class="function_type">
188
+ <span class="returnvalue">void</span>
189
+ </td>
190
+ <td class="function_name">
191
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-invert" title="graphene_quaternion_invert ()">graphene_quaternion_invert</a> <span class="c_punctuation">()</span>
192
+ </td>
193
+ </tr>
194
+ <tr>
195
+ <td class="function_type">
196
+ <span class="returnvalue">void</span>
197
+ </td>
198
+ <td class="function_name">
199
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-normalize" title="graphene_quaternion_normalize ()">graphene_quaternion_normalize</a> <span class="c_punctuation">()</span>
200
+ </td>
201
+ </tr>
202
+ <tr>
203
+ <td class="function_type">
204
+ <span class="returnvalue">void</span>
205
+ </td>
206
+ <td class="function_name">
207
+ <a class="link" href="graphene-Quaternion.html#graphene-quaternion-slerp" title="graphene_quaternion_slerp ()">graphene_quaternion_slerp</a> <span class="c_punctuation">()</span>
208
+ </td>
209
+ </tr>
210
+ </tbody>
211
+ </table></div>
212
+ </div>
213
+ <div class="refsect1">
214
+ <a name="graphene-Quaternion.other"></a><h2>Types and Values</h2>
215
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
216
+ <colgroup>
217
+ <col width="150px" class="name">
218
+ <col class="description">
219
+ </colgroup>
220
+ <tbody><tr>
221
+ <td class="datatype_keyword"> </td>
222
+ <td class="function_name"><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t">graphene_quaternion_t</a></td>
223
+ </tr></tbody>
224
+ </table></div>
225
+ </div>
226
+ <div class="refsect1">
227
+ <a name="graphene-Quaternion.includes"></a><h2>Includes</h2>
228
+ <pre class="synopsis">#include &lt;graphene.h&gt;
229
+ </pre>
230
+ </div>
231
+ <div class="refsect1">
232
+ <a name="graphene-Quaternion.description"></a><h2>Description</h2>
233
+ <p>Quaternions are a mathematical entity that can be used to represent
234
+ rotation transformations in 3D space; unlike the usual Euler representation
235
+ with roll, pitch, and yaw, quaternions do not suffer from the so-called
236
+ <a class="ulink" href="http://en.wikipedia.org/wiki/Gimbal_lock" target="_top">"Gimbal Lock"</a> problem.</p>
237
+ <p>See also: <a class="link" href="graphene-Euler.html#graphene-euler-t" title="graphene_euler_t"><span class="type">graphene_euler_t</span></a></p>
238
+ </div>
239
+ <div class="refsect1">
240
+ <a name="graphene-Quaternion.functions_details"></a><h2>Functions</h2>
241
+ <div class="refsect2">
242
+ <a name="graphene-quaternion-alloc"></a><h3>graphene_quaternion_alloc ()</h3>
243
+ <pre class="programlisting"><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="returnvalue">graphene_quaternion_t</span></a> *
244
+ graphene_quaternion_alloc (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
245
+ <p>Allocates a new <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a>.</p>
246
+ <p>The contents of the returned value are undefined.</p>
247
+ <p><span class="annotation">[<acronym title="This symbol is a constructor, not a static method."><span class="acronym">constructor</span></acronym>]</span></p>
248
+ <div class="refsect3">
249
+ <a name="graphene-quaternion-alloc.returns"></a><h4>Returns</h4>
250
+ <p> the newly allocated <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a>. </p>
251
+ <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
252
+ </div>
253
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
254
+ </div>
255
+ <hr>
256
+ <div class="refsect2">
257
+ <a name="graphene-quaternion-free"></a><h3>graphene_quaternion_free ()</h3>
258
+ <pre class="programlisting"><span class="returnvalue">void</span>
259
+ graphene_quaternion_free (<em class="parameter"><code><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *q</code></em>);</pre>
260
+ <p>Releases the resources allocated by <a class="link" href="graphene-Quaternion.html#graphene-quaternion-alloc" title="graphene_quaternion_alloc ()"><code class="function">graphene_quaternion_alloc()</code></a>.</p>
261
+ <div class="refsect3">
262
+ <a name="graphene-quaternion-free.parameters"></a><h4>Parameters</h4>
263
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
264
+ <colgroup>
265
+ <col width="150px" class="parameters_name">
266
+ <col class="parameters_description">
267
+ <col width="200px" class="parameters_annotations">
268
+ </colgroup>
269
+ <tbody><tr>
270
+ <td class="parameter_name"><p>q</p></td>
271
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
272
+ <td class="parameter_annotations"> </td>
273
+ </tr></tbody>
274
+ </table></div>
275
+ </div>
276
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
277
+ </div>
278
+ <hr>
279
+ <div class="refsect2">
280
+ <a name="graphene-quaternion-init"></a><h3>graphene_quaternion_init ()</h3>
281
+ <pre class="programlisting"><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="returnvalue">graphene_quaternion_t</span></a> *
282
+ graphene_quaternion_init (<em class="parameter"><code><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *q</code></em>,
283
+ <em class="parameter"><code><span class="type">float</span> x</code></em>,
284
+ <em class="parameter"><code><span class="type">float</span> y</code></em>,
285
+ <em class="parameter"><code><span class="type">float</span> z</code></em>,
286
+ <em class="parameter"><code><span class="type">float</span> w</code></em>);</pre>
287
+ <p>Initializes a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> using the given four values.</p>
288
+ <div class="refsect3">
289
+ <a name="graphene-quaternion-init.parameters"></a><h4>Parameters</h4>
290
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
291
+ <colgroup>
292
+ <col width="150px" class="parameters_name">
293
+ <col class="parameters_description">
294
+ <col width="200px" class="parameters_annotations">
295
+ </colgroup>
296
+ <tbody>
297
+ <tr>
298
+ <td class="parameter_name"><p>q</p></td>
299
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
300
+ <td class="parameter_annotations"> </td>
301
+ </tr>
302
+ <tr>
303
+ <td class="parameter_name"><p>x</p></td>
304
+ <td class="parameter_description"><p>the first component of the quaternion</p></td>
305
+ <td class="parameter_annotations"> </td>
306
+ </tr>
307
+ <tr>
308
+ <td class="parameter_name"><p>y</p></td>
309
+ <td class="parameter_description"><p>the second component of the quaternion</p></td>
310
+ <td class="parameter_annotations"> </td>
311
+ </tr>
312
+ <tr>
313
+ <td class="parameter_name"><p>z</p></td>
314
+ <td class="parameter_description"><p>the third component of the quaternion</p></td>
315
+ <td class="parameter_annotations"> </td>
316
+ </tr>
317
+ <tr>
318
+ <td class="parameter_name"><p>w</p></td>
319
+ <td class="parameter_description"><p>the fourth component of the quaternion</p></td>
320
+ <td class="parameter_annotations"> </td>
321
+ </tr>
322
+ </tbody>
323
+ </table></div>
324
+ </div>
325
+ <div class="refsect3">
326
+ <a name="graphene-quaternion-init.returns"></a><h4>Returns</h4>
327
+ <p> the initialized quaternion. </p>
328
+ <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
329
+ </div>
330
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
331
+ </div>
332
+ <hr>
333
+ <div class="refsect2">
334
+ <a name="graphene-quaternion-init-identity"></a><h3>graphene_quaternion_init_identity ()</h3>
335
+ <pre class="programlisting"><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="returnvalue">graphene_quaternion_t</span></a> *
336
+ graphene_quaternion_init_identity (<em class="parameter"><code><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *q</code></em>);</pre>
337
+ <p>Initializes a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> using the identity
338
+ transformation.</p>
339
+ <div class="refsect3">
340
+ <a name="graphene-quaternion-init-identity.parameters"></a><h4>Parameters</h4>
341
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
342
+ <colgroup>
343
+ <col width="150px" class="parameters_name">
344
+ <col class="parameters_description">
345
+ <col width="200px" class="parameters_annotations">
346
+ </colgroup>
347
+ <tbody><tr>
348
+ <td class="parameter_name"><p>q</p></td>
349
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
350
+ <td class="parameter_annotations"> </td>
351
+ </tr></tbody>
352
+ </table></div>
353
+ </div>
354
+ <div class="refsect3">
355
+ <a name="graphene-quaternion-init-identity.returns"></a><h4>Returns</h4>
356
+ <p> the initialized quaternion. </p>
357
+ <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
358
+ </div>
359
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
360
+ </div>
361
+ <hr>
362
+ <div class="refsect2">
363
+ <a name="graphene-quaternion-init-from-quaternion"></a><h3>graphene_quaternion_init_from_quaternion ()</h3>
364
+ <pre class="programlisting"><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="returnvalue">graphene_quaternion_t</span></a> *
365
+ graphene_quaternion_init_from_quaternion
366
+ (<em class="parameter"><code><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *q</code></em>,
367
+ <em class="parameter"><code>const <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *src</code></em>);</pre>
368
+ <p>Initializes a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> with the values from <em class="parameter"><code>src</code></em>
369
+ .</p>
370
+ <div class="refsect3">
371
+ <a name="graphene-quaternion-init-from-quaternion.parameters"></a><h4>Parameters</h4>
372
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
373
+ <colgroup>
374
+ <col width="150px" class="parameters_name">
375
+ <col class="parameters_description">
376
+ <col width="200px" class="parameters_annotations">
377
+ </colgroup>
378
+ <tbody>
379
+ <tr>
380
+ <td class="parameter_name"><p>q</p></td>
381
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
382
+ <td class="parameter_annotations"> </td>
383
+ </tr>
384
+ <tr>
385
+ <td class="parameter_name"><p>src</p></td>
386
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
387
+ <td class="parameter_annotations"> </td>
388
+ </tr>
389
+ </tbody>
390
+ </table></div>
391
+ </div>
392
+ <div class="refsect3">
393
+ <a name="graphene-quaternion-init-from-quaternion.returns"></a><h4>Returns</h4>
394
+ <p> the initialized quaternion. </p>
395
+ <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
396
+ </div>
397
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
398
+ </div>
399
+ <hr>
400
+ <div class="refsect2">
401
+ <a name="graphene-quaternion-init-from-vec4"></a><h3>graphene_quaternion_init_from_vec4 ()</h3>
402
+ <pre class="programlisting"><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="returnvalue">graphene_quaternion_t</span></a> *
403
+ graphene_quaternion_init_from_vec4 (<em class="parameter"><code><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *q</code></em>,
404
+ <em class="parameter"><code>const <a class="link" href="graphene-Vectors.html#graphene-vec4-t" title="graphene_vec4_t"><span class="type">graphene_vec4_t</span></a> *src</code></em>);</pre>
405
+ <p>Initializes a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> with the values from <em class="parameter"><code>src</code></em>
406
+ .</p>
407
+ <div class="refsect3">
408
+ <a name="graphene-quaternion-init-from-vec4.parameters"></a><h4>Parameters</h4>
409
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
410
+ <colgroup>
411
+ <col width="150px" class="parameters_name">
412
+ <col class="parameters_description">
413
+ <col width="200px" class="parameters_annotations">
414
+ </colgroup>
415
+ <tbody>
416
+ <tr>
417
+ <td class="parameter_name"><p>q</p></td>
418
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
419
+ <td class="parameter_annotations"> </td>
420
+ </tr>
421
+ <tr>
422
+ <td class="parameter_name"><p>src</p></td>
423
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Vectors.html#graphene-vec4-t" title="graphene_vec4_t"><span class="type">graphene_vec4_t</span></a></p></td>
424
+ <td class="parameter_annotations"> </td>
425
+ </tr>
426
+ </tbody>
427
+ </table></div>
428
+ </div>
429
+ <div class="refsect3">
430
+ <a name="graphene-quaternion-init-from-vec4.returns"></a><h4>Returns</h4>
431
+ <p> the initialized quaternion. </p>
432
+ <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
433
+ </div>
434
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
435
+ </div>
436
+ <hr>
437
+ <div class="refsect2">
438
+ <a name="graphene-quaternion-init-from-matrix"></a><h3>graphene_quaternion_init_from_matrix ()</h3>
439
+ <pre class="programlisting"><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="returnvalue">graphene_quaternion_t</span></a> *
440
+ graphene_quaternion_init_from_matrix (<em class="parameter"><code><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *q</code></em>,
441
+ <em class="parameter"><code>const <a class="link" href="graphene-Matrix.html#graphene-matrix-t" title="graphene_matrix_t"><span class="type">graphene_matrix_t</span></a> *m</code></em>);</pre>
442
+ <p>Initializes a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> using the rotation components
443
+ of a transformation matrix.</p>
444
+ <div class="refsect3">
445
+ <a name="graphene-quaternion-init-from-matrix.parameters"></a><h4>Parameters</h4>
446
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
447
+ <colgroup>
448
+ <col width="150px" class="parameters_name">
449
+ <col class="parameters_description">
450
+ <col width="200px" class="parameters_annotations">
451
+ </colgroup>
452
+ <tbody>
453
+ <tr>
454
+ <td class="parameter_name"><p>q</p></td>
455
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
456
+ <td class="parameter_annotations"> </td>
457
+ </tr>
458
+ <tr>
459
+ <td class="parameter_name"><p>m</p></td>
460
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Matrix.html#graphene-matrix-t" title="graphene_matrix_t"><span class="type">graphene_matrix_t</span></a></p></td>
461
+ <td class="parameter_annotations"> </td>
462
+ </tr>
463
+ </tbody>
464
+ </table></div>
465
+ </div>
466
+ <div class="refsect3">
467
+ <a name="graphene-quaternion-init-from-matrix.returns"></a><h4>Returns</h4>
468
+ <p> the initialized quaternion. </p>
469
+ <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
470
+ </div>
471
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
472
+ </div>
473
+ <hr>
474
+ <div class="refsect2">
475
+ <a name="graphene-quaternion-init-from-angles"></a><h3>graphene_quaternion_init_from_angles ()</h3>
476
+ <pre class="programlisting"><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="returnvalue">graphene_quaternion_t</span></a> *
477
+ graphene_quaternion_init_from_angles (<em class="parameter"><code><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *q</code></em>,
478
+ <em class="parameter"><code><span class="type">float</span> deg_x</code></em>,
479
+ <em class="parameter"><code><span class="type">float</span> deg_y</code></em>,
480
+ <em class="parameter"><code><span class="type">float</span> deg_z</code></em>);</pre>
481
+ <p>Initializes a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> using the values of
482
+ the <a class="ulink" href="http://en.wikipedia.org/wiki/Euler_angles" target="_top">Euler angles</a>
483
+ on each axis.</p>
484
+ <p>See also: <a class="link" href="graphene-Quaternion.html#graphene-quaternion-init-from-euler" title="graphene_quaternion_init_from_euler ()"><code class="function">graphene_quaternion_init_from_euler()</code></a></p>
485
+ <div class="refsect3">
486
+ <a name="graphene-quaternion-init-from-angles.parameters"></a><h4>Parameters</h4>
487
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
488
+ <colgroup>
489
+ <col width="150px" class="parameters_name">
490
+ <col class="parameters_description">
491
+ <col width="200px" class="parameters_annotations">
492
+ </colgroup>
493
+ <tbody>
494
+ <tr>
495
+ <td class="parameter_name"><p>q</p></td>
496
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
497
+ <td class="parameter_annotations"> </td>
498
+ </tr>
499
+ <tr>
500
+ <td class="parameter_name"><p>deg_x</p></td>
501
+ <td class="parameter_description"><p>rotation angle on the X axis (yaw), in degrees</p></td>
502
+ <td class="parameter_annotations"> </td>
503
+ </tr>
504
+ <tr>
505
+ <td class="parameter_name"><p>deg_y</p></td>
506
+ <td class="parameter_description"><p>rotation angle on the Y axis (pitch), in degrees</p></td>
507
+ <td class="parameter_annotations"> </td>
508
+ </tr>
509
+ <tr>
510
+ <td class="parameter_name"><p>deg_z</p></td>
511
+ <td class="parameter_description"><p>rotation angle on the Z axis (roll), in degrees</p></td>
512
+ <td class="parameter_annotations"> </td>
513
+ </tr>
514
+ </tbody>
515
+ </table></div>
516
+ </div>
517
+ <div class="refsect3">
518
+ <a name="graphene-quaternion-init-from-angles.returns"></a><h4>Returns</h4>
519
+ <p> the initialized quaternion. </p>
520
+ <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
521
+ </div>
522
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
523
+ </div>
524
+ <hr>
525
+ <div class="refsect2">
526
+ <a name="graphene-quaternion-init-from-radians"></a><h3>graphene_quaternion_init_from_radians ()</h3>
527
+ <pre class="programlisting"><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="returnvalue">graphene_quaternion_t</span></a> *
528
+ graphene_quaternion_init_from_radians (<em class="parameter"><code><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *q</code></em>,
529
+ <em class="parameter"><code><span class="type">float</span> rad_x</code></em>,
530
+ <em class="parameter"><code><span class="type">float</span> rad_y</code></em>,
531
+ <em class="parameter"><code><span class="type">float</span> rad_z</code></em>);</pre>
532
+ <p>Initializes a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> using the values of
533
+ the <a class="ulink" href="http://en.wikipedia.org/wiki/Euler_angles" target="_top">Euler angles</a>
534
+ on each axis.</p>
535
+ <p>See also: <a class="link" href="graphene-Quaternion.html#graphene-quaternion-init-from-euler" title="graphene_quaternion_init_from_euler ()"><code class="function">graphene_quaternion_init_from_euler()</code></a></p>
536
+ <div class="refsect3">
537
+ <a name="graphene-quaternion-init-from-radians.parameters"></a><h4>Parameters</h4>
538
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
539
+ <colgroup>
540
+ <col width="150px" class="parameters_name">
541
+ <col class="parameters_description">
542
+ <col width="200px" class="parameters_annotations">
543
+ </colgroup>
544
+ <tbody>
545
+ <tr>
546
+ <td class="parameter_name"><p>q</p></td>
547
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
548
+ <td class="parameter_annotations"> </td>
549
+ </tr>
550
+ <tr>
551
+ <td class="parameter_name"><p>rad_x</p></td>
552
+ <td class="parameter_description"><p>rotation angle on the X axis (yaw), in radians</p></td>
553
+ <td class="parameter_annotations"> </td>
554
+ </tr>
555
+ <tr>
556
+ <td class="parameter_name"><p>rad_y</p></td>
557
+ <td class="parameter_description"><p>rotation angle on the Y axis (pitch), in radians</p></td>
558
+ <td class="parameter_annotations"> </td>
559
+ </tr>
560
+ <tr>
561
+ <td class="parameter_name"><p>rad_z</p></td>
562
+ <td class="parameter_description"><p>rotation angle on the Z axis (roll), in radians</p></td>
563
+ <td class="parameter_annotations"> </td>
564
+ </tr>
565
+ </tbody>
566
+ </table></div>
567
+ </div>
568
+ <div class="refsect3">
569
+ <a name="graphene-quaternion-init-from-radians.returns"></a><h4>Returns</h4>
570
+ <p> the initialized quaternion. </p>
571
+ <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
572
+ </div>
573
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
574
+ </div>
575
+ <hr>
576
+ <div class="refsect2">
577
+ <a name="graphene-quaternion-init-from-angle-vec3"></a><h3>graphene_quaternion_init_from_angle_vec3 ()</h3>
578
+ <pre class="programlisting"><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="returnvalue">graphene_quaternion_t</span></a> *
579
+ graphene_quaternion_init_from_angle_vec3
580
+ (<em class="parameter"><code><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *q</code></em>,
581
+ <em class="parameter"><code><span class="type">float</span> angle</code></em>,
582
+ <em class="parameter"><code>const <a class="link" href="graphene-Vectors.html#graphene-vec3-t" title="graphene_vec3_t"><span class="type">graphene_vec3_t</span></a> *axis</code></em>);</pre>
583
+ <p>Initializes a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> using an <em class="parameter"><code>angle</code></em>
584
+ on a
585
+ specific <em class="parameter"><code>axis</code></em>
586
+ .</p>
587
+ <div class="refsect3">
588
+ <a name="graphene-quaternion-init-from-angle-vec3.parameters"></a><h4>Parameters</h4>
589
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
590
+ <colgroup>
591
+ <col width="150px" class="parameters_name">
592
+ <col class="parameters_description">
593
+ <col width="200px" class="parameters_annotations">
594
+ </colgroup>
595
+ <tbody>
596
+ <tr>
597
+ <td class="parameter_name"><p>q</p></td>
598
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
599
+ <td class="parameter_annotations"> </td>
600
+ </tr>
601
+ <tr>
602
+ <td class="parameter_name"><p>angle</p></td>
603
+ <td class="parameter_description"><p>the rotation on a given axis, in degrees</p></td>
604
+ <td class="parameter_annotations"> </td>
605
+ </tr>
606
+ <tr>
607
+ <td class="parameter_name"><p>axis</p></td>
608
+ <td class="parameter_description"><p>the axis of rotation, expressed as a vector</p></td>
609
+ <td class="parameter_annotations"> </td>
610
+ </tr>
611
+ </tbody>
612
+ </table></div>
613
+ </div>
614
+ <div class="refsect3">
615
+ <a name="graphene-quaternion-init-from-angle-vec3.returns"></a><h4>Returns</h4>
616
+ <p> the initialized quaternion. </p>
617
+ <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
618
+ </div>
619
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
620
+ </div>
621
+ <hr>
622
+ <div class="refsect2">
623
+ <a name="graphene-quaternion-init-from-euler"></a><h3>graphene_quaternion_init_from_euler ()</h3>
624
+ <pre class="programlisting"><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="returnvalue">graphene_quaternion_t</span></a> *
625
+ graphene_quaternion_init_from_euler (<em class="parameter"><code><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *q</code></em>,
626
+ <em class="parameter"><code>const <a class="link" href="graphene-Euler.html#graphene-euler-t" title="graphene_euler_t"><span class="type">graphene_euler_t</span></a> *e</code></em>);</pre>
627
+ <p>Initializes a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> using the given <a class="link" href="graphene-Euler.html#graphene-euler-t" title="graphene_euler_t"><span class="type">graphene_euler_t</span></a>.</p>
628
+ <div class="refsect3">
629
+ <a name="graphene-quaternion-init-from-euler.parameters"></a><h4>Parameters</h4>
630
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
631
+ <colgroup>
632
+ <col width="150px" class="parameters_name">
633
+ <col class="parameters_description">
634
+ <col width="200px" class="parameters_annotations">
635
+ </colgroup>
636
+ <tbody>
637
+ <tr>
638
+ <td class="parameter_name"><p>q</p></td>
639
+ <td class="parameter_description"><p>the <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> to initialize</p></td>
640
+ <td class="parameter_annotations"> </td>
641
+ </tr>
642
+ <tr>
643
+ <td class="parameter_name"><p>e</p></td>
644
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Euler.html#graphene-euler-t" title="graphene_euler_t"><span class="type">graphene_euler_t</span></a></p></td>
645
+ <td class="parameter_annotations"> </td>
646
+ </tr>
647
+ </tbody>
648
+ </table></div>
649
+ </div>
650
+ <div class="refsect3">
651
+ <a name="graphene-quaternion-init-from-euler.returns"></a><h4>Returns</h4>
652
+ <p> the initialized <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a>. </p>
653
+ <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
654
+ </div>
655
+ <p class="since">Since: <a class="link" href="ix04.html#api-index-1.2">1.2</a></p>
656
+ </div>
657
+ <hr>
658
+ <div class="refsect2">
659
+ <a name="graphene-quaternion-to-vec4"></a><h3>graphene_quaternion_to_vec4 ()</h3>
660
+ <pre class="programlisting"><span class="returnvalue">void</span>
661
+ graphene_quaternion_to_vec4 (<em class="parameter"><code>const <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *q</code></em>,
662
+ <em class="parameter"><code><a class="link" href="graphene-Vectors.html#graphene-vec4-t" title="graphene_vec4_t"><span class="type">graphene_vec4_t</span></a> *res</code></em>);</pre>
663
+ <p>Copies the components of a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> into a
664
+ <a class="link" href="graphene-Vectors.html#graphene-vec4-t" title="graphene_vec4_t"><span class="type">graphene_vec4_t</span></a>.</p>
665
+ <div class="refsect3">
666
+ <a name="graphene-quaternion-to-vec4.parameters"></a><h4>Parameters</h4>
667
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
668
+ <colgroup>
669
+ <col width="150px" class="parameters_name">
670
+ <col class="parameters_description">
671
+ <col width="200px" class="parameters_annotations">
672
+ </colgroup>
673
+ <tbody>
674
+ <tr>
675
+ <td class="parameter_name"><p>q</p></td>
676
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
677
+ <td class="parameter_annotations"> </td>
678
+ </tr>
679
+ <tr>
680
+ <td class="parameter_name"><p>res</p></td>
681
+ <td class="parameter_description"><p> return location for a
682
+ <a class="link" href="graphene-Vectors.html#graphene-vec4-t" title="graphene_vec4_t"><span class="type">graphene_vec4_t</span></a>. </p></td>
683
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out caller-allocates</span></acronym>]</span></td>
684
+ </tr>
685
+ </tbody>
686
+ </table></div>
687
+ </div>
688
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
689
+ </div>
690
+ <hr>
691
+ <div class="refsect2">
692
+ <a name="graphene-quaternion-to-matrix"></a><h3>graphene_quaternion_to_matrix ()</h3>
693
+ <pre class="programlisting"><span class="returnvalue">void</span>
694
+ graphene_quaternion_to_matrix (<em class="parameter"><code>const <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *q</code></em>,
695
+ <em class="parameter"><code><a class="link" href="graphene-Matrix.html#graphene-matrix-t" title="graphene_matrix_t"><span class="type">graphene_matrix_t</span></a> *m</code></em>);</pre>
696
+ <p>Converts a quaternion into a transformation matrix expressing
697
+ the rotation defined by the <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a>.</p>
698
+ <div class="refsect3">
699
+ <a name="graphene-quaternion-to-matrix.parameters"></a><h4>Parameters</h4>
700
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
701
+ <colgroup>
702
+ <col width="150px" class="parameters_name">
703
+ <col class="parameters_description">
704
+ <col width="200px" class="parameters_annotations">
705
+ </colgroup>
706
+ <tbody>
707
+ <tr>
708
+ <td class="parameter_name"><p>q</p></td>
709
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
710
+ <td class="parameter_annotations"> </td>
711
+ </tr>
712
+ <tr>
713
+ <td class="parameter_name"><p>m</p></td>
714
+ <td class="parameter_description"><p> a <a class="link" href="graphene-Matrix.html#graphene-matrix-t" title="graphene_matrix_t"><span class="type">graphene_matrix_t</span></a>. </p></td>
715
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out caller-allocates</span></acronym>]</span></td>
716
+ </tr>
717
+ </tbody>
718
+ </table></div>
719
+ </div>
720
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
721
+ </div>
722
+ <hr>
723
+ <div class="refsect2">
724
+ <a name="graphene-quaternion-to-angles"></a><h3>graphene_quaternion_to_angles ()</h3>
725
+ <pre class="programlisting"><span class="returnvalue">void</span>
726
+ graphene_quaternion_to_angles (<em class="parameter"><code>const <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *q</code></em>,
727
+ <em class="parameter"><code><span class="type">float</span> *deg_x</code></em>,
728
+ <em class="parameter"><code><span class="type">float</span> *deg_y</code></em>,
729
+ <em class="parameter"><code><span class="type">float</span> *deg_z</code></em>);</pre>
730
+ <p>Converts a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> to its corresponding rotations
731
+ on the <a class="ulink" href="http://en.wikipedia.org/wiki/Euler_angles" target="_top">Euler angles</a>
732
+ on each axis.</p>
733
+ <div class="refsect3">
734
+ <a name="graphene-quaternion-to-angles.parameters"></a><h4>Parameters</h4>
735
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
736
+ <colgroup>
737
+ <col width="150px" class="parameters_name">
738
+ <col class="parameters_description">
739
+ <col width="200px" class="parameters_annotations">
740
+ </colgroup>
741
+ <tbody>
742
+ <tr>
743
+ <td class="parameter_name"><p>q</p></td>
744
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
745
+ <td class="parameter_annotations"> </td>
746
+ </tr>
747
+ <tr>
748
+ <td class="parameter_name"><p>deg_x</p></td>
749
+ <td class="parameter_description"><p> return location for the rotation angle on
750
+ the X axis (yaw), in degrees. </p></td>
751
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td>
752
+ </tr>
753
+ <tr>
754
+ <td class="parameter_name"><p>deg_y</p></td>
755
+ <td class="parameter_description"><p> return location for the rotation angle on
756
+ the Y axis (pitch), in degrees. </p></td>
757
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td>
758
+ </tr>
759
+ <tr>
760
+ <td class="parameter_name"><p>deg_z</p></td>
761
+ <td class="parameter_description"><p> return location for the rotation angle on
762
+ the Z axis (roll), in degrees. </p></td>
763
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td>
764
+ </tr>
765
+ </tbody>
766
+ </table></div>
767
+ </div>
768
+ <p class="since">Since: <a class="link" href="ix04.html#api-index-1.2">1.2</a></p>
769
+ </div>
770
+ <hr>
771
+ <div class="refsect2">
772
+ <a name="graphene-quaternion-to-radians"></a><h3>graphene_quaternion_to_radians ()</h3>
773
+ <pre class="programlisting"><span class="returnvalue">void</span>
774
+ graphene_quaternion_to_radians (<em class="parameter"><code>const <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *q</code></em>,
775
+ <em class="parameter"><code><span class="type">float</span> *rad_x</code></em>,
776
+ <em class="parameter"><code><span class="type">float</span> *rad_y</code></em>,
777
+ <em class="parameter"><code><span class="type">float</span> *rad_z</code></em>);</pre>
778
+ <p>Converts a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> to its corresponding rotations
779
+ on the <a class="ulink" href="http://en.wikipedia.org/wiki/Euler_angles" target="_top">Euler angles</a>
780
+ on each axis.</p>
781
+ <div class="refsect3">
782
+ <a name="graphene-quaternion-to-radians.parameters"></a><h4>Parameters</h4>
783
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
784
+ <colgroup>
785
+ <col width="150px" class="parameters_name">
786
+ <col class="parameters_description">
787
+ <col width="200px" class="parameters_annotations">
788
+ </colgroup>
789
+ <tbody>
790
+ <tr>
791
+ <td class="parameter_name"><p>q</p></td>
792
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
793
+ <td class="parameter_annotations"> </td>
794
+ </tr>
795
+ <tr>
796
+ <td class="parameter_name"><p>rad_x</p></td>
797
+ <td class="parameter_description"><p> return location for the rotation angle on
798
+ the X axis (yaw), in radians. </p></td>
799
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td>
800
+ </tr>
801
+ <tr>
802
+ <td class="parameter_name"><p>rad_y</p></td>
803
+ <td class="parameter_description"><p> return location for the rotation angle on
804
+ the Y axis (pitch), in radians. </p></td>
805
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td>
806
+ </tr>
807
+ <tr>
808
+ <td class="parameter_name"><p>rad_z</p></td>
809
+ <td class="parameter_description"><p> return location for the rotation angle on
810
+ the Z axis (roll), in radians. </p></td>
811
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td>
812
+ </tr>
813
+ </tbody>
814
+ </table></div>
815
+ </div>
816
+ <p class="since">Since: <a class="link" href="ix04.html#api-index-1.2">1.2</a></p>
817
+ </div>
818
+ <hr>
819
+ <div class="refsect2">
820
+ <a name="graphene-quaternion-to-angle-vec3"></a><h3>graphene_quaternion_to_angle_vec3 ()</h3>
821
+ <pre class="programlisting"><span class="returnvalue">void</span>
822
+ graphene_quaternion_to_angle_vec3 (<em class="parameter"><code>const <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *q</code></em>,
823
+ <em class="parameter"><code><span class="type">float</span> *angle</code></em>,
824
+ <em class="parameter"><code><a class="link" href="graphene-Vectors.html#graphene-vec3-t" title="graphene_vec3_t"><span class="type">graphene_vec3_t</span></a> *axis</code></em>);</pre>
825
+ <p>Converts a quaternion into an <em class="parameter"><code>angle</code></em>
826
+ , <em class="parameter"><code>axis</code></em>
827
+ pair.</p>
828
+ <div class="refsect3">
829
+ <a name="graphene-quaternion-to-angle-vec3.parameters"></a><h4>Parameters</h4>
830
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
831
+ <colgroup>
832
+ <col width="150px" class="parameters_name">
833
+ <col class="parameters_description">
834
+ <col width="200px" class="parameters_annotations">
835
+ </colgroup>
836
+ <tbody>
837
+ <tr>
838
+ <td class="parameter_name"><p>q</p></td>
839
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
840
+ <td class="parameter_annotations"> </td>
841
+ </tr>
842
+ <tr>
843
+ <td class="parameter_name"><p>angle</p></td>
844
+ <td class="parameter_description"><p> return location for the angle, in degrees. </p></td>
845
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
846
+ </tr>
847
+ <tr>
848
+ <td class="parameter_name"><p>axis</p></td>
849
+ <td class="parameter_description"><p> return location for the rotation axis. </p></td>
850
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out caller-allocates</span></acronym>]</span></td>
851
+ </tr>
852
+ </tbody>
853
+ </table></div>
854
+ </div>
855
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
856
+ </div>
857
+ <hr>
858
+ <div class="refsect2">
859
+ <a name="graphene-quaternion-equal"></a><h3>graphene_quaternion_equal ()</h3>
860
+ <pre class="programlisting"><span class="returnvalue">bool</span>
861
+ graphene_quaternion_equal (<em class="parameter"><code>const <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *a</code></em>,
862
+ <em class="parameter"><code>const <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *b</code></em>);</pre>
863
+ <p>Checks whether the given quaternions are equal.</p>
864
+ <div class="refsect3">
865
+ <a name="graphene-quaternion-equal.parameters"></a><h4>Parameters</h4>
866
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
867
+ <colgroup>
868
+ <col width="150px" class="parameters_name">
869
+ <col class="parameters_description">
870
+ <col width="200px" class="parameters_annotations">
871
+ </colgroup>
872
+ <tbody>
873
+ <tr>
874
+ <td class="parameter_name"><p>a</p></td>
875
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
876
+ <td class="parameter_annotations"> </td>
877
+ </tr>
878
+ <tr>
879
+ <td class="parameter_name"><p>b</p></td>
880
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
881
+ <td class="parameter_annotations"> </td>
882
+ </tr>
883
+ </tbody>
884
+ </table></div>
885
+ </div>
886
+ <div class="refsect3">
887
+ <a name="graphene-quaternion-equal.returns"></a><h4>Returns</h4>
888
+ <p> <code class="literal">true</code> if the quaternions are equal</p>
889
+ </div>
890
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
891
+ </div>
892
+ <hr>
893
+ <div class="refsect2">
894
+ <a name="graphene-quaternion-dot"></a><h3>graphene_quaternion_dot ()</h3>
895
+ <pre class="programlisting"><span class="returnvalue">float</span>
896
+ graphene_quaternion_dot (<em class="parameter"><code>const <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *a</code></em>,
897
+ <em class="parameter"><code>const <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *b</code></em>);</pre>
898
+ <p>Computes the dot product of two <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a>.</p>
899
+ <div class="refsect3">
900
+ <a name="graphene-quaternion-dot.parameters"></a><h4>Parameters</h4>
901
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
902
+ <colgroup>
903
+ <col width="150px" class="parameters_name">
904
+ <col class="parameters_description">
905
+ <col width="200px" class="parameters_annotations">
906
+ </colgroup>
907
+ <tbody>
908
+ <tr>
909
+ <td class="parameter_name"><p>a</p></td>
910
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
911
+ <td class="parameter_annotations"> </td>
912
+ </tr>
913
+ <tr>
914
+ <td class="parameter_name"><p>b</p></td>
915
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
916
+ <td class="parameter_annotations"> </td>
917
+ </tr>
918
+ </tbody>
919
+ </table></div>
920
+ </div>
921
+ <div class="refsect3">
922
+ <a name="graphene-quaternion-dot.returns"></a><h4>Returns</h4>
923
+ <p> the value of the dot products</p>
924
+ </div>
925
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
926
+ </div>
927
+ <hr>
928
+ <div class="refsect2">
929
+ <a name="graphene-quaternion-invert"></a><h3>graphene_quaternion_invert ()</h3>
930
+ <pre class="programlisting"><span class="returnvalue">void</span>
931
+ graphene_quaternion_invert (<em class="parameter"><code>const <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *q</code></em>,
932
+ <em class="parameter"><code><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *res</code></em>);</pre>
933
+ <p>Inverts a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a>.</p>
934
+ <div class="refsect3">
935
+ <a name="graphene-quaternion-invert.parameters"></a><h4>Parameters</h4>
936
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
937
+ <colgroup>
938
+ <col width="150px" class="parameters_name">
939
+ <col class="parameters_description">
940
+ <col width="200px" class="parameters_annotations">
941
+ </colgroup>
942
+ <tbody>
943
+ <tr>
944
+ <td class="parameter_name"><p>q</p></td>
945
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
946
+ <td class="parameter_annotations"> </td>
947
+ </tr>
948
+ <tr>
949
+ <td class="parameter_name"><p>res</p></td>
950
+ <td class="parameter_description"><p> return location for the inverted
951
+ quaternion. </p></td>
952
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out caller-allocates</span></acronym>]</span></td>
953
+ </tr>
954
+ </tbody>
955
+ </table></div>
956
+ </div>
957
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
958
+ </div>
959
+ <hr>
960
+ <div class="refsect2">
961
+ <a name="graphene-quaternion-normalize"></a><h3>graphene_quaternion_normalize ()</h3>
962
+ <pre class="programlisting"><span class="returnvalue">void</span>
963
+ graphene_quaternion_normalize (<em class="parameter"><code>const <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *q</code></em>,
964
+ <em class="parameter"><code><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *res</code></em>);</pre>
965
+ <p>Normalizes a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a>.</p>
966
+ <div class="refsect3">
967
+ <a name="graphene-quaternion-normalize.parameters"></a><h4>Parameters</h4>
968
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
969
+ <colgroup>
970
+ <col width="150px" class="parameters_name">
971
+ <col class="parameters_description">
972
+ <col width="200px" class="parameters_annotations">
973
+ </colgroup>
974
+ <tbody>
975
+ <tr>
976
+ <td class="parameter_name"><p>q</p></td>
977
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
978
+ <td class="parameter_annotations"> </td>
979
+ </tr>
980
+ <tr>
981
+ <td class="parameter_name"><p>res</p></td>
982
+ <td class="parameter_description"><p> return location for the normalized
983
+ quaternion. </p></td>
984
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out caller-allocates</span></acronym>]</span></td>
985
+ </tr>
986
+ </tbody>
987
+ </table></div>
988
+ </div>
989
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
990
+ </div>
991
+ <hr>
992
+ <div class="refsect2">
993
+ <a name="graphene-quaternion-slerp"></a><h3>graphene_quaternion_slerp ()</h3>
994
+ <pre class="programlisting"><span class="returnvalue">void</span>
995
+ graphene_quaternion_slerp (<em class="parameter"><code>const <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *a</code></em>,
996
+ <em class="parameter"><code>const <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *b</code></em>,
997
+ <em class="parameter"><code><span class="type">float</span> factor</code></em>,
998
+ <em class="parameter"><code><a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> *res</code></em>);</pre>
999
+ <p>Interpolates between the two given quaternions using a spherical
1000
+ linear interpolation, or <a class="ulink" href="http://en.wikipedia.org/wiki/Slerp" target="_top">SLERP</a>,
1001
+ using the given interpolation <em class="parameter"><code>factor</code></em>
1002
+ .</p>
1003
+ <div class="refsect3">
1004
+ <a name="graphene-quaternion-slerp.parameters"></a><h4>Parameters</h4>
1005
+ <div class="informaltable"><table class="informaltable" width="100%" border="0">
1006
+ <colgroup>
1007
+ <col width="150px" class="parameters_name">
1008
+ <col class="parameters_description">
1009
+ <col width="200px" class="parameters_annotations">
1010
+ </colgroup>
1011
+ <tbody>
1012
+ <tr>
1013
+ <td class="parameter_name"><p>a</p></td>
1014
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
1015
+ <td class="parameter_annotations"> </td>
1016
+ </tr>
1017
+ <tr>
1018
+ <td class="parameter_name"><p>b</p></td>
1019
+ <td class="parameter_description"><p>a <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a></p></td>
1020
+ <td class="parameter_annotations"> </td>
1021
+ </tr>
1022
+ <tr>
1023
+ <td class="parameter_name"><p>factor</p></td>
1024
+ <td class="parameter_description"><p>the linear interpolation factor</p></td>
1025
+ <td class="parameter_annotations"> </td>
1026
+ </tr>
1027
+ <tr>
1028
+ <td class="parameter_name"><p>res</p></td>
1029
+ <td class="parameter_description"><p> return location for the interpolated
1030
+ quaternion. </p></td>
1031
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out caller-allocates</span></acronym>]</span></td>
1032
+ </tr>
1033
+ </tbody>
1034
+ </table></div>
1035
+ </div>
1036
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
1037
+ </div>
1038
+ </div>
1039
+ <div class="refsect1">
1040
+ <a name="graphene-Quaternion.other_details"></a><h2>Types and Values</h2>
1041
+ <div class="refsect2">
1042
+ <a name="graphene-quaternion-t"></a><h3>graphene_quaternion_t</h3>
1043
+ <pre class="programlisting">typedef struct {
1044
+ } graphene_quaternion_t;
1045
+ </pre>
1046
+ <p>A quaternion.</p>
1047
+ <p>The contents of the <a class="link" href="graphene-Quaternion.html#graphene-quaternion-t" title="graphene_quaternion_t"><span class="type">graphene_quaternion_t</span></a> structure are private
1048
+ and should never be accessed directly.</p>
1049
+ <p class="since">Since: <a class="link" href="ix03.html#api-index-1.0">1.0</a></p>
1050
+ </div>
1051
+ </div>
1052
+ </div>
1053
+ <div class="footer">
1054
+ <hr>Generated by GTK-Doc V1.25</div>
1055
+ </body>
1056
+ </html>