clutter 2.2.0-x86-mingw32 → 2.2.1-x86-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (631) hide show
  1. checksums.yaml +4 -4
  2. data/Rakefile +14 -5
  3. data/lib/clutter.rb +1 -2
  4. data/vendor/local/bin/json-glib-format.exe +0 -0
  5. data/vendor/local/bin/json-glib-validate.exe +0 -0
  6. data/vendor/local/bin/libclutter-1.0-0.dll +0 -0
  7. data/vendor/local/bin/{libcogl-15.dll → libcogl-20.dll} +0 -0
  8. data/vendor/local/bin/libcogl-pango-20.dll +0 -0
  9. data/vendor/local/bin/libcogl-path-20.dll +0 -0
  10. data/vendor/local/bin/libjson-glib-1.0-0.dll +0 -0
  11. data/vendor/local/include/clutter-1.0/cally/cally-actor.h +9 -4
  12. data/vendor/local/include/clutter-1.0/cally/cally-clone.h +6 -4
  13. data/vendor/local/include/clutter-1.0/cally/cally-group.h +5 -3
  14. data/vendor/local/include/clutter-1.0/cally/cally-main.h +7 -2
  15. data/vendor/local/include/clutter-1.0/cally/cally-rectangle.h +5 -3
  16. data/vendor/local/include/clutter-1.0/cally/cally-root.h +6 -4
  17. data/vendor/local/include/clutter-1.0/cally/cally-stage.h +5 -3
  18. data/vendor/local/include/clutter-1.0/cally/cally-text.h +6 -4
  19. data/vendor/local/include/clutter-1.0/cally/cally-texture.h +6 -4
  20. data/vendor/local/include/clutter-1.0/cally/cally-util.h +7 -3
  21. data/vendor/local/include/clutter-1.0/clutter/clutter-action.h +13 -5
  22. data/vendor/local/include/clutter-1.0/clutter/clutter-actor-meta.h +8 -2
  23. data/vendor/local/include/clutter-1.0/clutter/clutter-actor.h +90 -1
  24. data/vendor/local/include/clutter-1.0/clutter/clutter-align-constraint.h +9 -1
  25. data/vendor/local/include/clutter-1.0/clutter/clutter-animatable.h +5 -0
  26. data/vendor/local/include/clutter-1.0/clutter/clutter-backend.h +15 -9
  27. data/vendor/local/include/clutter-1.0/clutter/clutter-bin-layout.h +4 -2
  28. data/vendor/local/include/clutter-1.0/clutter/clutter-bind-constraint.h +9 -1
  29. data/vendor/local/include/clutter-1.0/clutter/clutter-binding-pool.h +13 -0
  30. data/vendor/local/include/clutter-1.0/clutter/clutter-blur-effect.h +3 -1
  31. data/vendor/local/include/clutter-1.0/clutter/clutter-box-layout.h +9 -0
  32. data/vendor/local/include/clutter-1.0/clutter/clutter-brightness-contrast-effect.h +9 -1
  33. data/vendor/local/include/clutter-1.0/clutter/clutter-cairo.h +2 -0
  34. data/vendor/local/include/clutter-1.0/clutter/clutter-canvas.h +7 -2
  35. data/vendor/local/include/clutter-1.0/clutter/clutter-child-meta.h +10 -8
  36. data/vendor/local/include/clutter-1.0/clutter/clutter-click-action.h +8 -2
  37. data/vendor/local/include/clutter-1.0/clutter/clutter-clone.h +8 -4
  38. data/vendor/local/include/clutter-1.0/clutter/clutter-color.h +32 -7
  39. data/vendor/local/include/clutter-1.0/clutter/clutter-colorize-effect.h +5 -1
  40. data/vendor/local/include/clutter-1.0/clutter/clutter-constraint.h +14 -2
  41. data/vendor/local/include/clutter-1.0/clutter/clutter-container.h +49 -37
  42. data/vendor/local/include/clutter-1.0/clutter/clutter-content.h +2 -2
  43. data/vendor/local/include/clutter-1.0/clutter/clutter-deform-effect.h +19 -13
  44. data/vendor/local/include/clutter-1.0/clutter/clutter-deprecated.h +1 -0
  45. data/vendor/local/include/clutter-1.0/clutter/clutter-desaturate-effect.h +5 -1
  46. data/vendor/local/include/clutter-1.0/clutter/clutter-device-manager.h +6 -2
  47. data/vendor/local/include/clutter-1.0/clutter/clutter-drag-action.h +12 -2
  48. data/vendor/local/include/clutter-1.0/clutter/clutter-drop-action.h +4 -2
  49. data/vendor/local/include/clutter-1.0/clutter/clutter-effect.h +11 -1
  50. data/vendor/local/include/clutter-1.0/clutter/clutter-enum-types.h +62 -55
  51. data/vendor/local/include/clutter-1.0/clutter/clutter-enums.h +23 -0
  52. data/vendor/local/include/clutter-1.0/clutter/clutter-event.h +74 -8
  53. data/vendor/local/include/clutter-1.0/clutter/clutter-feature.h +2 -0
  54. data/vendor/local/include/clutter-1.0/clutter/clutter-fixed-layout.h +2 -0
  55. data/vendor/local/include/clutter-1.0/clutter/clutter-flow-layout.h +14 -0
  56. data/vendor/local/include/clutter-1.0/clutter/clutter-gesture-action.h +27 -2
  57. data/vendor/local/include/clutter-1.0/clutter/clutter-group.h +1 -0
  58. data/vendor/local/include/clutter-1.0/clutter/clutter-image.h +2 -2
  59. data/vendor/local/include/clutter-1.0/clutter/clutter-input-device.h +20 -0
  60. data/vendor/local/include/clutter-1.0/clutter/clutter-interval.h +18 -0
  61. data/vendor/local/include/clutter-1.0/clutter/clutter-layout-manager.h +13 -0
  62. data/vendor/local/include/clutter-1.0/clutter/clutter-layout-meta.h +2 -0
  63. data/vendor/local/include/clutter-1.0/clutter/clutter-list-model.h +3 -0
  64. data/vendor/local/include/clutter-1.0/clutter/clutter-macros.h +67 -33
  65. data/vendor/local/include/clutter-1.0/clutter/clutter-main.h +36 -0
  66. data/vendor/local/include/clutter-1.0/clutter/clutter-model.h +42 -1
  67. data/vendor/local/include/clutter-1.0/clutter/clutter-offscreen-effect.h +4 -0
  68. data/vendor/local/include/clutter-1.0/clutter/clutter-page-turn-effect.h +9 -1
  69. data/vendor/local/include/clutter-1.0/clutter/clutter-paint-nodes.h +5 -5
  70. data/vendor/local/include/clutter-1.0/clutter/clutter-pan-action.h +2 -2
  71. data/vendor/local/include/clutter-1.0/clutter/clutter-path-constraint.h +7 -1
  72. data/vendor/local/include/clutter-1.0/clutter/clutter-path.h +26 -0
  73. data/vendor/local/include/clutter-1.0/clutter/clutter-property-transition.h +2 -2
  74. data/vendor/local/include/clutter-1.0/clutter/clutter-rotate-action.h +2 -2
  75. data/vendor/local/include/clutter-1.0/clutter/clutter-script.h +16 -0
  76. data/vendor/local/include/clutter-1.0/clutter/clutter-scriptable.h +5 -0
  77. data/vendor/local/include/clutter-1.0/clutter/clutter-scroll-actor.h +2 -2
  78. data/vendor/local/include/clutter-1.0/clutter/clutter-settings.h +2 -0
  79. data/vendor/local/include/clutter-1.0/clutter/clutter-shader-effect.h +9 -2
  80. data/vendor/local/include/clutter-1.0/clutter/clutter-shader-types.h +10 -1
  81. data/vendor/local/include/clutter-1.0/clutter/clutter-snap-constraint.h +9 -1
  82. data/vendor/local/include/clutter-1.0/clutter/clutter-stage-manager.h +5 -0
  83. data/vendor/local/include/clutter-1.0/clutter/clutter-stage.h +35 -9
  84. data/vendor/local/include/clutter-1.0/clutter/clutter-swipe-action.h +4 -2
  85. data/vendor/local/include/clutter-1.0/clutter/clutter-tap-action.h +2 -2
  86. data/vendor/local/include/clutter-1.0/clutter/clutter-test-utils.h +164 -0
  87. data/vendor/local/include/clutter-1.0/clutter/clutter-text-buffer.h +2 -2
  88. data/vendor/local/include/clutter-1.0/clutter/clutter-text.h +67 -0
  89. data/vendor/local/include/clutter-1.0/clutter/clutter-texture.h +2 -0
  90. data/vendor/local/include/clutter-1.0/clutter/clutter-timeline.h +25 -0
  91. data/vendor/local/include/clutter-1.0/clutter/clutter-transition-group.h +2 -2
  92. data/vendor/local/include/clutter-1.0/clutter/clutter-transition.h +2 -2
  93. data/vendor/local/include/clutter-1.0/clutter/clutter-types.h +60 -6
  94. data/vendor/local/include/clutter-1.0/clutter/clutter-units.h +18 -0
  95. data/vendor/local/include/clutter-1.0/clutter/clutter-version.h +37 -20
  96. data/vendor/local/include/clutter-1.0/clutter/clutter-zoom-action.h +2 -2
  97. data/vendor/local/include/clutter-1.0/clutter/clutter.h +2 -3
  98. data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-fixed.h +1 -0
  99. data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-state.h +3 -3
  100. data/vendor/local/include/clutter-1.0/clutter/{clutter-table-layout.h → deprecated/clutter-table-layout.h} +15 -0
  101. data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-timeout-pool.h +1 -1
  102. data/vendor/local/include/clutter-1.0/clutter/win32/clutter-win32.h +5 -0
  103. data/vendor/local/include/cogl/cogl-pango/cogl-pango.h +33 -14
  104. data/vendor/local/include/cogl/cogl-path/cogl-path-types.h +18 -14
  105. data/vendor/local/include/cogl/cogl-path/cogl-path.h +22 -12
  106. data/vendor/local/include/cogl/cogl-path/cogl1-path-functions.h +20 -13
  107. data/vendor/local/include/cogl/cogl-path/cogl2-path-functions.h +35 -13
  108. data/vendor/local/include/cogl/cogl/cogl-atlas-texture.h +81 -53
  109. data/vendor/local/include/cogl/cogl/cogl-attribute-buffer.h +31 -11
  110. data/vendor/local/include/cogl/cogl/cogl-attribute.h +31 -11
  111. data/vendor/local/include/cogl/cogl/cogl-auto-texture.h +221 -0
  112. data/vendor/local/include/cogl/cogl/cogl-bitmap.h +31 -11
  113. data/vendor/local/include/cogl/cogl/cogl-buffer.h +26 -13
  114. data/vendor/local/include/cogl/cogl/cogl-clip-state.h +244 -15
  115. data/vendor/local/include/cogl/cogl/cogl-clutter.h +18 -13
  116. data/vendor/local/include/cogl/cogl/cogl-color.h +31 -11
  117. data/vendor/local/include/cogl/cogl/cogl-context.h +41 -14
  118. data/vendor/local/include/cogl/cogl/cogl-defines.h +20 -13
  119. data/vendor/local/include/cogl/cogl/cogl-deprecated.h +18 -11
  120. data/vendor/local/include/cogl/cogl/cogl-depth-state.h +20 -14
  121. data/vendor/local/include/cogl/cogl/cogl-display.h +33 -14
  122. data/vendor/local/include/cogl/cogl/cogl-enum-types.h +9 -6
  123. data/vendor/local/include/cogl/cogl/cogl-error.h +20 -15
  124. data/vendor/local/include/cogl/cogl/cogl-euler.h +31 -13
  125. data/vendor/local/include/cogl/cogl/cogl-fence.h +20 -13
  126. data/vendor/local/include/cogl/cogl/cogl-fixed.h +20 -13
  127. data/vendor/local/include/cogl/cogl/cogl-frame-info.h +31 -12
  128. data/vendor/local/include/cogl/cogl/cogl-framebuffer-deprecated.h +264 -0
  129. data/vendor/local/include/cogl/cogl/cogl-framebuffer.h +70 -29
  130. data/vendor/local/include/cogl/cogl/cogl-gles2.h +64 -18
  131. data/vendor/local/include/cogl/cogl/cogl-glib-source.h +18 -11
  132. data/vendor/local/include/cogl/cogl/cogl-index-buffer.h +31 -11
  133. data/vendor/local/include/cogl/cogl/cogl-indices.h +31 -11
  134. data/vendor/local/include/cogl/cogl/cogl-macros.h +33 -13
  135. data/vendor/local/include/cogl/cogl/cogl-material-compat.h +20 -13
  136. data/vendor/local/include/cogl/cogl/cogl-matrix-stack.h +37 -12
  137. data/vendor/local/include/cogl/cogl/cogl-matrix.h +34 -15
  138. data/vendor/local/include/cogl/cogl/cogl-meta-texture.h +25 -12
  139. data/vendor/local/include/cogl/cogl/cogl-object.h +40 -12
  140. data/vendor/local/include/cogl/cogl/cogl-offscreen.h +31 -11
  141. data/vendor/local/include/cogl/cogl/cogl-onscreen-template.h +31 -12
  142. data/vendor/local/include/cogl/cogl/cogl-onscreen.h +63 -12
  143. data/vendor/local/include/cogl/cogl/cogl-output.h +31 -12
  144. data/vendor/local/include/cogl/cogl/cogl-pango.h +18 -11
  145. data/vendor/local/include/cogl/cogl/cogl-pipeline-layer-state.h +20 -13
  146. data/vendor/local/include/cogl/cogl/cogl-pipeline-state.h +20 -13
  147. data/vendor/local/include/cogl/cogl/cogl-pipeline.h +31 -11
  148. data/vendor/local/include/cogl/cogl/cogl-pixel-buffer.h +31 -11
  149. data/vendor/local/include/cogl/cogl/cogl-poll.h +20 -14
  150. data/vendor/local/include/cogl/cogl/cogl-primitive-texture.h +25 -12
  151. data/vendor/local/include/cogl/cogl/cogl-primitive.h +32 -13
  152. data/vendor/local/include/cogl/cogl/cogl-primitives.h +20 -13
  153. data/vendor/local/include/cogl/cogl/cogl-quaternion.h +34 -15
  154. data/vendor/local/include/cogl/cogl/cogl-renderer.h +33 -15
  155. data/vendor/local/include/cogl/cogl/cogl-shader.h +20 -13
  156. data/vendor/local/include/cogl/cogl/cogl-snippet.h +27 -12
  157. data/vendor/local/include/cogl/cogl/cogl-sub-texture.h +29 -15
  158. data/vendor/local/include/cogl/cogl/cogl-swap-chain.h +33 -13
  159. data/vendor/local/include/cogl/cogl/cogl-texture-2d-gl.h +29 -24
  160. data/vendor/local/include/cogl/cogl/cogl-texture-2d-sliced.h +54 -49
  161. data/vendor/local/include/cogl/cogl/cogl-texture-2d.h +81 -65
  162. data/vendor/local/include/cogl/cogl/cogl-texture-3d.h +71 -54
  163. data/vendor/local/include/cogl/cogl/cogl-texture-deprecated.h +105 -0
  164. data/vendor/local/include/cogl/cogl/cogl-texture-rectangle.h +61 -48
  165. data/vendor/local/include/cogl/cogl/cogl-texture.h +157 -241
  166. data/vendor/local/include/cogl/cogl/cogl-type-casts.h +53 -0
  167. data/vendor/local/include/cogl/cogl/cogl-types.h +23 -11
  168. data/vendor/local/include/cogl/cogl/cogl-vector.h +20 -15
  169. data/vendor/local/include/cogl/cogl/cogl-version.h +28 -12
  170. data/vendor/local/include/cogl/cogl/cogl-vertex-buffer.h +20 -13
  171. data/vendor/local/include/cogl/cogl/cogl-win32-renderer.h +18 -13
  172. data/vendor/local/include/cogl/cogl/cogl.h +61 -22
  173. data/vendor/local/include/cogl/cogl/cogl1-context.h +20 -434
  174. data/vendor/local/include/cogl/cogl/cogl2-experimental.h +18 -12
  175. data/vendor/local/include/cogl/cogl/deprecated/cogl-auto-texture.h +221 -0
  176. data/vendor/local/include/cogl/cogl/deprecated/cogl-clip-state.h +266 -0
  177. data/vendor/local/include/cogl/cogl/deprecated/cogl-clutter.h +54 -0
  178. data/vendor/local/include/cogl/cogl/deprecated/cogl-fixed.h +811 -0
  179. data/vendor/local/include/cogl/cogl/deprecated/cogl-framebuffer-deprecated.h +264 -0
  180. data/vendor/local/include/cogl/cogl/deprecated/cogl-material-compat.h +1391 -0
  181. data/vendor/local/include/cogl/cogl/deprecated/cogl-shader.h +704 -0
  182. data/vendor/local/include/cogl/cogl/deprecated/cogl-texture-deprecated.h +105 -0
  183. data/vendor/local/include/cogl/cogl/deprecated/cogl-type-casts.h +53 -0
  184. data/vendor/local/include/cogl/cogl/deprecated/cogl-vertex-buffer.h +451 -0
  185. data/vendor/local/include/cogl/cogl/gl-prototypes/cogl-core-functions.h +18 -11
  186. data/vendor/local/include/cogl/cogl/gl-prototypes/cogl-gles2-functions.h +18 -11
  187. data/vendor/local/include/cogl/cogl/gl-prototypes/cogl-glsl-functions.h +18 -11
  188. data/vendor/local/include/cogl/cogl/gl-prototypes/cogl-in-gles-core-functions.h +18 -11
  189. data/vendor/local/include/cogl/cogl/gl-prototypes/cogl-in-gles2-core-functions.h +18 -11
  190. data/vendor/local/include/json-glib-1.0/json-glib/json-builder.h +21 -7
  191. data/vendor/local/include/json-glib-1.0/json-glib/json-enum-types.h +8 -3
  192. data/vendor/local/include/json-glib-1.0/json-glib/json-generator.h +16 -3
  193. data/vendor/local/include/json-glib-1.0/json-glib/json-glib.h +1 -0
  194. data/vendor/local/include/json-glib-1.0/json-glib/json-gobject.h +23 -5
  195. data/vendor/local/include/json-glib-1.0/json-glib/json-gvariant.h +9 -2
  196. data/vendor/local/include/json-glib-1.0/json-glib/json-parser.h +17 -4
  197. data/vendor/local/include/json-glib-1.0/json-glib/json-path.h +13 -8
  198. data/vendor/local/include/json-glib-1.0/json-glib/json-reader.h +28 -7
  199. data/vendor/local/include/json-glib-1.0/json-glib/json-types.h +97 -12
  200. data/vendor/local/include/json-glib-1.0/json-glib/json-version-macros.h +135 -0
  201. data/vendor/local/include/json-glib-1.0/json-glib/json-version.h +14 -12
  202. data/vendor/local/lib/girepository-1.0/Clutter-1.0.typelib +0 -0
  203. data/vendor/local/lib/girepository-1.0/Cogl-1.0.typelib +0 -0
  204. data/vendor/local/lib/girepository-1.0/Cogl-2.0.typelib +0 -0
  205. data/vendor/local/lib/girepository-1.0/CoglPango-1.0.typelib +0 -0
  206. data/vendor/local/lib/girepository-1.0/CoglPango-2.0.typelib +0 -0
  207. data/vendor/local/lib/girepository-1.0/Json-1.0.typelib +0 -0
  208. data/vendor/local/lib/libclutter-1.0.dll.a +0 -0
  209. data/vendor/local/lib/libclutter-1.0.la +4 -4
  210. data/vendor/local/lib/libcogl-pango.dll.a +0 -0
  211. data/vendor/local/lib/libcogl-pango.la +5 -5
  212. data/vendor/local/lib/libcogl-path.dll.a +0 -0
  213. data/vendor/local/lib/libcogl-path.la +41 -0
  214. data/vendor/local/lib/libcogl.dll.a +0 -0
  215. data/vendor/local/lib/libcogl.la +5 -5
  216. data/vendor/local/lib/libjson-glib-1.0.dll.a +0 -0
  217. data/vendor/local/lib/libjson-glib-1.0.la +3 -3
  218. data/vendor/local/lib/pkgconfig/cally-1.0.pc +1 -1
  219. data/vendor/local/lib/pkgconfig/clutter-1.0.pc +2 -2
  220. data/vendor/local/lib/pkgconfig/clutter-win32-1.0.pc +2 -2
  221. data/vendor/local/lib/pkgconfig/cogl-1.0.pc +1 -1
  222. data/vendor/local/lib/pkgconfig/cogl-gl-1.0.pc +1 -1
  223. data/vendor/local/lib/pkgconfig/cogl-pango-1.0.pc +1 -1
  224. data/vendor/local/lib/pkgconfig/cogl-pango-2.0-experimental.pc +3 -3
  225. data/vendor/local/lib/pkgconfig/cogl-path-1.0.pc +13 -0
  226. data/vendor/local/lib/pkgconfig/cogl-path-2.0-experimental.pc +13 -0
  227. data/vendor/local/lib/pkgconfig/json-glib-1.0.pc +1 -1
  228. data/vendor/local/share/gir-1.0/Cally-1.0.gir +4 -2
  229. data/vendor/local/share/gir-1.0/Clutter-1.0.gir +4527 -1814
  230. data/vendor/local/share/gir-1.0/Cogl-1.0.gir +1194 -1881
  231. data/vendor/local/share/gir-1.0/Cogl-2.0.gir +20369 -0
  232. data/vendor/local/share/gir-1.0/CoglPango-1.0.gir +9 -5
  233. data/vendor/local/share/gir-1.0/CoglPango-2.0.gir +331 -0
  234. data/vendor/local/share/gir-1.0/Json-1.0.gir +363 -163
  235. data/vendor/local/share/gtk-doc/html/cally/CallyActor.html +356 -259
  236. data/vendor/local/share/gtk-doc/html/cally/CallyClone.html +91 -69
  237. data/vendor/local/share/gtk-doc/html/cally/CallyGroup.html +89 -71
  238. data/vendor/local/share/gtk-doc/html/cally/CallyRectangle.html +90 -68
  239. data/vendor/local/share/gtk-doc/html/cally/CallyRoot.html +72 -59
  240. data/vendor/local/share/gtk-doc/html/cally/CallyStage.html +92 -70
  241. data/vendor/local/share/gtk-doc/html/cally/CallyText.html +90 -66
  242. data/vendor/local/share/gtk-doc/html/cally/CallyTexture.html +90 -68
  243. data/vendor/local/share/gtk-doc/html/cally/CallyUtil.html +42 -37
  244. data/vendor/local/share/gtk-doc/html/cally/cally-General-API.html +109 -86
  245. data/vendor/local/share/gtk-doc/html/cally/cally.devhelp2 +16 -16
  246. data/vendor/local/share/gtk-doc/html/cally/callyannotationglossary.html +4 -4
  247. data/vendor/local/share/gtk-doc/html/cally/callybase.html +4 -4
  248. data/vendor/local/share/gtk-doc/html/cally/callyobjecthierarchy.html +16 -16
  249. data/vendor/local/share/gtk-doc/html/cally/callyobjectindex.html +4 -4
  250. data/vendor/local/share/gtk-doc/html/cally/callyobjects.html +4 -4
  251. data/vendor/local/share/gtk-doc/html/cally/ch01.html +4 -4
  252. data/vendor/local/share/gtk-doc/html/cally/ch02.html +4 -4
  253. data/vendor/local/share/gtk-doc/html/cally/clutter-overview.html +4 -4
  254. data/vendor/local/share/gtk-doc/html/cally/index.html +3 -3
  255. data/vendor/local/share/gtk-doc/html/cally/index.sgml +47 -29
  256. data/vendor/local/share/gtk-doc/html/cally/ix01.html +27 -29
  257. data/vendor/local/share/gtk-doc/html/cally/ix02.html +4 -4
  258. data/vendor/local/share/gtk-doc/html/cally/ix03.html +25 -27
  259. data/vendor/local/share/gtk-doc/html/cally/ix04.html +6 -6
  260. data/vendor/local/share/gtk-doc/html/cally/license.html +4 -4
  261. data/vendor/local/share/gtk-doc/html/cally/style.css +260 -105
  262. data/vendor/local/share/gtk-doc/html/clutter/ClutterAction.html +47 -45
  263. data/vendor/local/share/gtk-doc/html/clutter/ClutterActor.html +11634 -9660
  264. data/vendor/local/share/gtk-doc/html/clutter/ClutterActorMeta.html +283 -206
  265. data/vendor/local/share/gtk-doc/html/clutter/ClutterAlignConstraint.html +335 -242
  266. data/vendor/local/share/gtk-doc/html/clutter/ClutterAlpha.html +595 -523
  267. data/vendor/local/share/gtk-doc/html/clutter/ClutterAnimatable.html +341 -273
  268. data/vendor/local/share/gtk-doc/html/clutter/ClutterAnimator.html +995 -804
  269. data/vendor/local/share/gtk-doc/html/clutter/ClutterBackend.html +583 -432
  270. data/vendor/local/share/gtk-doc/html/clutter/ClutterBehaviour.html +565 -457
  271. data/vendor/local/share/gtk-doc/html/clutter/ClutterBehaviourDepth.html +207 -169
  272. data/vendor/local/share/gtk-doc/html/clutter/ClutterBehaviourEllipse.html +718 -518
  273. data/vendor/local/share/gtk-doc/html/clutter/ClutterBehaviourOpacity.html +211 -172
  274. data/vendor/local/share/gtk-doc/html/clutter/ClutterBehaviourPath.html +338 -283
  275. data/vendor/local/share/gtk-doc/html/clutter/ClutterBehaviourRotate.html +506 -367
  276. data/vendor/local/share/gtk-doc/html/clutter/ClutterBehaviourScale.html +322 -275
  277. data/vendor/local/share/gtk-doc/html/clutter/ClutterBinLayout.html +329 -901
  278. data/vendor/local/share/gtk-doc/html/clutter/ClutterBindConstraint.html +374 -553
  279. data/vendor/local/share/gtk-doc/html/clutter/ClutterBlurEffect.html +65 -55
  280. data/vendor/local/share/gtk-doc/html/clutter/ClutterBox.html +491 -419
  281. data/vendor/local/share/gtk-doc/html/clutter/ClutterBoxLayout.html +1032 -790
  282. data/vendor/local/share/gtk-doc/html/clutter/ClutterBrightnessContrastEffect.html +316 -243
  283. data/vendor/local/share/gtk-doc/html/clutter/ClutterCairoTexture.html +613 -755
  284. data/vendor/local/share/gtk-doc/html/clutter/ClutterCanvas.html +367 -373
  285. data/vendor/local/share/gtk-doc/html/clutter/ClutterChildMeta.html +181 -144
  286. data/vendor/local/share/gtk-doc/html/clutter/ClutterClickAction.html +399 -316
  287. data/vendor/local/share/gtk-doc/html/clutter/ClutterClone.html +177 -135
  288. data/vendor/local/share/gtk-doc/html/clutter/ClutterColorizeEffect.html +154 -105
  289. data/vendor/local/share/gtk-doc/html/clutter/ClutterConstraint.html +137 -262
  290. data/vendor/local/share/gtk-doc/html/clutter/ClutterContainer.html +1119 -851
  291. data/vendor/local/share/gtk-doc/html/clutter/ClutterContent.html +238 -177
  292. data/vendor/local/share/gtk-doc/html/clutter/ClutterDeformEffect.html +293 -225
  293. data/vendor/local/share/gtk-doc/html/clutter/ClutterDesaturateEffect.html +159 -114
  294. data/vendor/local/share/gtk-doc/html/clutter/ClutterDeviceManager.html +330 -243
  295. data/vendor/local/share/gtk-doc/html/clutter/ClutterDragAction.html +772 -873
  296. data/vendor/local/share/gtk-doc/html/clutter/ClutterDropAction.html +304 -766
  297. data/vendor/local/share/gtk-doc/html/clutter/ClutterEffect.html +353 -267
  298. data/vendor/local/share/gtk-doc/html/clutter/ClutterFixedLayout.html +70 -57
  299. data/vendor/local/share/gtk-doc/html/clutter/ClutterFlowLayout.html +646 -825
  300. data/vendor/local/share/gtk-doc/html/clutter/ClutterGestureAction.html +991 -555
  301. data/vendor/local/share/gtk-doc/html/clutter/ClutterGridLayout.html +725 -510
  302. data/vendor/local/share/gtk-doc/html/clutter/ClutterGroup.html +177 -133
  303. data/vendor/local/share/gtk-doc/html/clutter/ClutterImage.html +380 -512
  304. data/vendor/local/share/gtk-doc/html/clutter/ClutterInputDevice.html +1252 -962
  305. data/vendor/local/share/gtk-doc/html/clutter/ClutterKeyframeTransition.html +414 -320
  306. data/vendor/local/share/gtk-doc/html/clutter/ClutterLayoutManager.html +830 -923
  307. data/vendor/local/share/gtk-doc/html/clutter/ClutterLayoutMeta.html +118 -87
  308. data/vendor/local/share/gtk-doc/html/clutter/ClutterListModel.html +144 -130
  309. data/vendor/local/share/gtk-doc/html/clutter/ClutterMedia.html +742 -586
  310. data/vendor/local/share/gtk-doc/html/clutter/ClutterModel.html +1398 -1058
  311. data/vendor/local/share/gtk-doc/html/clutter/ClutterModelIter.html +563 -425
  312. data/vendor/local/share/gtk-doc/html/clutter/ClutterOffscreenEffect.html +322 -265
  313. data/vendor/local/share/gtk-doc/html/clutter/ClutterPageTurnEffect.html +292 -194
  314. data/vendor/local/share/gtk-doc/html/clutter/ClutterPaintNode.html +473 -333
  315. data/vendor/local/share/gtk-doc/html/clutter/ClutterPanAction.html +653 -489
  316. data/vendor/local/share/gtk-doc/html/clutter/ClutterPath.html +1107 -855
  317. data/vendor/local/share/gtk-doc/html/clutter/ClutterPathConstraint.html +277 -188
  318. data/vendor/local/share/gtk-doc/html/clutter/ClutterPropertyTransition.html +178 -130
  319. data/vendor/local/share/gtk-doc/html/clutter/ClutterRectangle.html +334 -216
  320. data/vendor/local/share/gtk-doc/html/clutter/ClutterRotateAction.html +131 -95
  321. data/vendor/local/share/gtk-doc/html/clutter/ClutterScore.html +709 -569
  322. data/vendor/local/share/gtk-doc/html/clutter/ClutterScript.html +958 -899
  323. data/vendor/local/share/gtk-doc/html/clutter/ClutterScriptable.html +242 -186
  324. data/vendor/local/share/gtk-doc/html/clutter/ClutterScrollActor.html +263 -606
  325. data/vendor/local/share/gtk-doc/html/clutter/ClutterSettings.html +243 -165
  326. data/vendor/local/share/gtk-doc/html/clutter/ClutterShaderEffect.html +469 -368
  327. data/vendor/local/share/gtk-doc/html/clutter/ClutterSnapConstraint.html +353 -245
  328. data/vendor/local/share/gtk-doc/html/clutter/ClutterStage.html +1967 -1513
  329. data/vendor/local/share/gtk-doc/html/clutter/ClutterState.html +1273 -1005
  330. data/vendor/local/share/gtk-doc/html/clutter/ClutterSwipeAction.html +200 -144
  331. data/vendor/local/share/gtk-doc/html/clutter/ClutterTableLayout.html +995 -745
  332. data/vendor/local/share/gtk-doc/html/clutter/ClutterTapAction.html +123 -93
  333. data/vendor/local/share/gtk-doc/html/clutter/ClutterText.html +2742 -1997
  334. data/vendor/local/share/gtk-doc/html/clutter/ClutterTextBuffer.html +647 -474
  335. data/vendor/local/share/gtk-doc/html/clutter/ClutterTexture.html +1482 -1223
  336. data/vendor/local/share/gtk-doc/html/clutter/ClutterTimeline.html +2161 -1735
  337. data/vendor/local/share/gtk-doc/html/clutter/ClutterTransition.html +496 -383
  338. data/vendor/local/share/gtk-doc/html/clutter/ClutterTransitionGroup.html +175 -135
  339. data/vendor/local/share/gtk-doc/html/clutter/ClutterZoomAction.html +313 -236
  340. data/vendor/local/share/gtk-doc/html/clutter/annotation-glossary.html +29 -13
  341. data/vendor/local/share/gtk-doc/html/clutter/building-clutter.html +4 -4
  342. data/vendor/local/share/gtk-doc/html/clutter/ch01.html +4 -4
  343. data/vendor/local/share/gtk-doc/html/clutter/ch02.html +4 -7
  344. data/vendor/local/share/gtk-doc/html/clutter/ch03.html +4 -8
  345. data/vendor/local/share/gtk-doc/html/clutter/ch04.html +4 -4
  346. data/vendor/local/share/gtk-doc/html/clutter/ch05.html +4 -4
  347. data/vendor/local/share/gtk-doc/html/clutter/ch06.html +4 -4
  348. data/vendor/local/share/gtk-doc/html/clutter/ch07.html +4 -4
  349. data/vendor/local/share/gtk-doc/html/clutter/ch08.html +4 -4
  350. data/vendor/local/share/gtk-doc/html/clutter/ch09.html +4 -4
  351. data/vendor/local/share/gtk-doc/html/clutter/ch10.html +5 -5
  352. data/vendor/local/share/gtk-doc/html/clutter/ch11.html +4 -4
  353. data/vendor/local/share/gtk-doc/html/clutter/ch12.html +4 -4
  354. data/vendor/local/share/gtk-doc/html/clutter/clutter-Base-geometric-types.html +3059 -2295
  355. data/vendor/local/share/gtk-doc/html/clutter/clutter-ClutterGLXTexturePixmap.html +181 -137
  356. data/vendor/local/share/gtk-doc/html/clutter/clutter-ClutterWaylandSurface.html +340 -197
  357. data/vendor/local/share/gtk-doc/html/clutter/clutter-ClutterX11TexturePixmap.html +306 -222
  358. data/vendor/local/share/gtk-doc/html/clutter/clutter-Colors.html +1272 -988
  359. data/vendor/local/share/gtk-doc/html/clutter/clutter-EGL-Specific-Support.html +154 -69
  360. data/vendor/local/share/gtk-doc/html/clutter/clutter-Events.html +2714 -1972
  361. data/vendor/local/share/gtk-doc/html/clutter/clutter-Features.html +151 -116
  362. data/vendor/local/share/gtk-doc/html/clutter/clutter-GDK-Specific-Support.html +205 -154
  363. data/vendor/local/share/gtk-doc/html/clutter/clutter-General.html +1455 -1890
  364. data/vendor/local/share/gtk-doc/html/clutter/clutter-Implicit-Animations.html +1449 -1804
  365. data/vendor/local/share/gtk-doc/html/clutter/clutter-Intel-CE3100-CE4100-Specific-Support.html +134 -112
  366. data/vendor/local/share/gtk-doc/html/clutter/clutter-Key-Bindings.html +625 -520
  367. data/vendor/local/share/gtk-doc/html/clutter/clutter-Paint-Nodes.html +302 -239
  368. data/vendor/local/share/gtk-doc/html/clutter/clutter-Shaders.html +872 -637
  369. data/vendor/local/share/gtk-doc/html/clutter/clutter-Stage-Manager.html +293 -213
  370. data/vendor/local/share/gtk-doc/html/clutter/clutter-Unit-conversion.html +674 -508
  371. data/vendor/local/share/gtk-doc/html/clutter/clutter-Utilities.html +454 -339
  372. data/vendor/local/share/gtk-doc/html/clutter/clutter-Value-intervals.html +816 -623
  373. data/vendor/local/share/gtk-doc/html/clutter/clutter-Versioning-Macros.html +346 -302
  374. data/vendor/local/share/gtk-doc/html/clutter/clutter-Wayland-compositor-specific-support.html +60 -34
  375. data/vendor/local/share/gtk-doc/html/clutter/clutter-Wayland-specific-support.html +200 -170
  376. data/vendor/local/share/gtk-doc/html/clutter/clutter-Win32-Specific-Support.html +162 -119
  377. data/vendor/local/share/gtk-doc/html/clutter/clutter-X11-Specific-Support.html +678 -565
  378. data/vendor/local/share/gtk-doc/html/clutter/clutter-overview.html +5 -5
  379. data/vendor/local/share/gtk-doc/html/clutter/clutter.devhelp2 +1937 -2272
  380. data/vendor/local/share/gtk-doc/html/clutter/clutteranimation.html +4 -4
  381. data/vendor/local/share/gtk-doc/html/clutter/clutterbackends.html +4 -4
  382. data/vendor/local/share/gtk-doc/html/clutter/clutterbase.html +4 -11
  383. data/vendor/local/share/gtk-doc/html/clutter/clutterglossary.html +4 -4
  384. data/vendor/local/share/gtk-doc/html/clutter/clutterobjecthierarchy.html +87 -87
  385. data/vendor/local/share/gtk-doc/html/clutter/clutterobjectindex.html +4 -4
  386. data/vendor/local/share/gtk-doc/html/clutter/clutterobjects.html +6 -6
  387. data/vendor/local/share/gtk-doc/html/clutter/cluttertools.html +5 -5
  388. data/vendor/local/share/gtk-doc/html/clutter/deprecated.html +11 -4
  389. data/vendor/local/share/gtk-doc/html/clutter/go01.html +4 -4
  390. data/vendor/local/share/gtk-doc/html/clutter/index.html +11 -11
  391. data/vendor/local/share/gtk-doc/html/clutter/index.sgml +842 -978
  392. data/vendor/local/share/gtk-doc/html/clutter/iterating-paths.html +7 -7
  393. data/vendor/local/share/gtk-doc/html/clutter/ix01.html +2005 -1923
  394. data/vendor/local/share/gtk-doc/html/clutter/ix02.html +663 -470
  395. data/vendor/local/share/gtk-doc/html/clutter/ix03.html +83 -85
  396. data/vendor/local/share/gtk-doc/html/clutter/ix04.html +122 -124
  397. data/vendor/local/share/gtk-doc/html/clutter/ix05.html +217 -219
  398. data/vendor/local/share/gtk-doc/html/clutter/ix06.html +148 -150
  399. data/vendor/local/share/gtk-doc/html/clutter/ix07.html +349 -351
  400. data/vendor/local/share/gtk-doc/html/clutter/ix08.html +177 -179
  401. data/vendor/local/share/gtk-doc/html/clutter/ix09.html +214 -216
  402. data/vendor/local/share/gtk-doc/html/clutter/ix10.html +83 -85
  403. data/vendor/local/share/gtk-doc/html/clutter/ix11.html +80 -82
  404. data/vendor/local/share/gtk-doc/html/clutter/ix12.html +219 -221
  405. data/vendor/local/share/gtk-doc/html/clutter/ix13.html +212 -214
  406. data/vendor/local/share/gtk-doc/html/clutter/ix14.html +22 -32
  407. data/vendor/local/share/gtk-doc/html/clutter/license.html +4 -4
  408. data/vendor/local/share/gtk-doc/html/clutter/migrating-ClutterAnimation.html +16 -16
  409. data/vendor/local/share/gtk-doc/html/clutter/migrating-ClutterBehaviour.html +15 -15
  410. data/vendor/local/share/gtk-doc/html/clutter/migrating-ClutterEffect.html +17 -17
  411. data/vendor/local/share/gtk-doc/html/clutter/migrating-ClutterPath.html +11 -12
  412. data/vendor/local/share/gtk-doc/html/clutter/migration.html +4 -4
  413. data/vendor/local/share/gtk-doc/html/clutter/pt09.html +4 -4
  414. data/vendor/local/share/gtk-doc/html/clutter/running-clutter.html +9 -4
  415. data/vendor/local/share/gtk-doc/html/clutter/style.css +260 -105
  416. data/vendor/local/share/gtk-doc/html/clutter/using-cairo.html +6 -6
  417. data/vendor/local/share/gtk-doc/html/json-glib/JsonBuilder.html +513 -392
  418. data/vendor/local/share/gtk-doc/html/json-glib/JsonGenerator.html +479 -347
  419. data/vendor/local/share/gtk-doc/html/json-glib/JsonParser.html +804 -600
  420. data/vendor/local/share/gtk-doc/html/json-glib/JsonPath.html +395 -362
  421. data/vendor/local/share/gtk-doc/html/json-glib/JsonReader.html +788 -609
  422. data/vendor/local/share/gtk-doc/html/json-glib/annotation-glossary.html +32 -43
  423. data/vendor/local/share/gtk-doc/html/json-glib/ch01.html +9 -9
  424. data/vendor/local/share/gtk-doc/html/json-glib/ch02.html +9 -9
  425. data/vendor/local/share/gtk-doc/html/json-glib/ch03.html +9 -9
  426. data/vendor/local/share/gtk-doc/html/json-glib/ch05.html +40 -0
  427. data/vendor/local/share/gtk-doc/html/json-glib/home.png +0 -0
  428. data/vendor/local/share/gtk-doc/html/json-glib/index.html +15 -6
  429. data/vendor/local/share/gtk-doc/html/json-glib/index.sgml +82 -73
  430. data/vendor/local/share/gtk-doc/html/json-glib/ix01.html +230 -227
  431. data/vendor/local/share/gtk-doc/html/json-glib/ix02.html +17 -22
  432. data/vendor/local/share/gtk-doc/html/json-glib/ix03.html +20 -25
  433. data/vendor/local/share/gtk-doc/html/json-glib/ix04.html +17 -22
  434. data/vendor/local/share/gtk-doc/html/json-glib/ix05.html +50 -55
  435. data/vendor/local/share/gtk-doc/html/json-glib/ix06.html +30 -35
  436. data/vendor/local/share/gtk-doc/html/json-glib/ix07.html +39 -44
  437. data/vendor/local/share/gtk-doc/html/json-glib/ix08.html +35 -40
  438. data/vendor/local/share/gtk-doc/html/json-glib/json-advanced.html +12 -9
  439. data/vendor/local/share/gtk-doc/html/json-glib/json-base.html +9 -9
  440. data/vendor/local/share/gtk-doc/html/json-glib/json-format-tool.html +84 -0
  441. data/vendor/local/share/gtk-doc/html/json-glib/json-glib-Boxed-Types-Serialization.html +306 -221
  442. data/vendor/local/share/gtk-doc/html/json-glib/json-glib-GObject-Serialization.html +261 -204
  443. data/vendor/local/share/gtk-doc/html/json-glib/json-glib-JSON-Array.html +843 -583
  444. data/vendor/local/share/gtk-doc/html/json-glib/json-glib-JSON-GVariant-Integration.html +223 -199
  445. data/vendor/local/share/gtk-doc/html/json-glib/json-glib-JSON-Node.html +1327 -912
  446. data/vendor/local/share/gtk-doc/html/json-glib/json-glib-JSON-Object.html +986 -694
  447. data/vendor/local/share/gtk-doc/html/json-glib/json-glib-Serializable-Interface.html +386 -301
  448. data/vendor/local/share/gtk-doc/html/json-glib/json-glib-Versioning-information.html +151 -87
  449. data/vendor/local/share/gtk-doc/html/json-glib/json-glib.devhelp2 +204 -218
  450. data/vendor/local/share/gtk-doc/html/json-glib/json-glib.html +9 -9
  451. data/vendor/local/share/gtk-doc/html/json-glib/json-streams.html +9 -9
  452. data/vendor/local/share/gtk-doc/html/json-glib/json-tools.html +19 -13
  453. data/vendor/local/share/gtk-doc/html/json-glib/json-validate-tool.html +72 -0
  454. data/vendor/local/share/gtk-doc/html/json-glib/left-insensitive.png +0 -0
  455. data/vendor/local/share/gtk-doc/html/json-glib/left.png +0 -0
  456. data/vendor/local/share/gtk-doc/html/json-glib/license.html +9 -9
  457. data/vendor/local/share/gtk-doc/html/json-glib/right-insensitive.png +0 -0
  458. data/vendor/local/share/gtk-doc/html/json-glib/right.png +0 -0
  459. data/vendor/local/share/gtk-doc/html/json-glib/style.css +314 -104
  460. data/vendor/local/share/gtk-doc/html/json-glib/tools.html +38 -0
  461. data/vendor/local/share/gtk-doc/html/json-glib/up-insensitive.png +0 -0
  462. data/vendor/local/share/gtk-doc/html/json-glib/up.png +0 -0
  463. data/vendor/local/share/license/cogl/COPYING +107 -502
  464. data/vendor/local/share/locale/an/LC_MESSAGES/clutter-1.0.mo +0 -0
  465. data/vendor/local/share/locale/an/LC_MESSAGES/cogl.mo +0 -0
  466. data/vendor/local/share/locale/ar/LC_MESSAGES/clutter-1.0.mo +0 -0
  467. data/vendor/local/share/locale/ar/LC_MESSAGES/cogl.mo +0 -0
  468. data/vendor/local/share/locale/as/LC_MESSAGES/clutter-1.0.mo +0 -0
  469. data/vendor/local/share/locale/as/LC_MESSAGES/cogl.mo +0 -0
  470. data/vendor/local/share/locale/as/LC_MESSAGES/json-glib-1.0.mo +0 -0
  471. data/vendor/local/share/locale/ast/LC_MESSAGES/clutter-1.0.mo +0 -0
  472. data/vendor/local/share/locale/ast/LC_MESSAGES/cogl.mo +0 -0
  473. data/vendor/local/share/locale/az_IR/LC_MESSAGES/clutter-1.0.mo +0 -0
  474. data/vendor/local/share/locale/be/LC_MESSAGES/clutter-1.0.mo +0 -0
  475. data/vendor/local/share/locale/be/LC_MESSAGES/cogl.mo +0 -0
  476. data/vendor/local/share/locale/bg/LC_MESSAGES/clutter-1.0.mo +0 -0
  477. data/vendor/local/share/locale/bg/LC_MESSAGES/cogl.mo +0 -0
  478. data/vendor/local/share/locale/bg/LC_MESSAGES/json-glib-1.0.mo +0 -0
  479. data/vendor/local/share/locale/bn_IN/LC_MESSAGES/json-glib-1.0.mo +0 -0
  480. data/vendor/local/share/locale/ca/LC_MESSAGES/clutter-1.0.mo +0 -0
  481. data/vendor/local/share/locale/ca/LC_MESSAGES/cogl.mo +0 -0
  482. data/vendor/local/share/locale/ca/LC_MESSAGES/json-glib-1.0.mo +0 -0
  483. data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/clutter-1.0.mo +0 -0
  484. data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/cogl.mo +0 -0
  485. data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/json-glib-1.0.mo +0 -0
  486. data/vendor/local/share/locale/cs/LC_MESSAGES/clutter-1.0.mo +0 -0
  487. data/vendor/local/share/locale/cs/LC_MESSAGES/cogl.mo +0 -0
  488. data/vendor/local/share/locale/cs/LC_MESSAGES/json-glib-1.0.mo +0 -0
  489. data/vendor/local/share/locale/da/LC_MESSAGES/clutter-1.0.mo +0 -0
  490. data/vendor/local/share/locale/da/LC_MESSAGES/cogl.mo +0 -0
  491. data/vendor/local/share/locale/da/LC_MESSAGES/json-glib-1.0.mo +0 -0
  492. data/vendor/local/share/locale/de/LC_MESSAGES/clutter-1.0.mo +0 -0
  493. data/vendor/local/share/locale/de/LC_MESSAGES/cogl.mo +0 -0
  494. data/vendor/local/share/locale/de/LC_MESSAGES/json-glib-1.0.mo +0 -0
  495. data/vendor/local/share/locale/el/LC_MESSAGES/clutter-1.0.mo +0 -0
  496. data/vendor/local/share/locale/el/LC_MESSAGES/cogl.mo +0 -0
  497. data/vendor/local/share/locale/el/LC_MESSAGES/json-glib-1.0.mo +0 -0
  498. data/vendor/local/share/locale/en_CA/LC_MESSAGES/cogl.mo +0 -0
  499. data/vendor/local/share/locale/en_GB/LC_MESSAGES/clutter-1.0.mo +0 -0
  500. data/vendor/local/share/locale/en_GB/LC_MESSAGES/cogl.mo +0 -0
  501. data/vendor/local/share/locale/en_GB/LC_MESSAGES/json-glib-1.0.mo +0 -0
  502. data/vendor/local/share/locale/eo/LC_MESSAGES/clutter-1.0.mo +0 -0
  503. data/vendor/local/share/locale/eo/LC_MESSAGES/cogl.mo +0 -0
  504. data/vendor/local/share/locale/eo/LC_MESSAGES/json-glib-1.0.mo +0 -0
  505. data/vendor/local/share/locale/es/LC_MESSAGES/clutter-1.0.mo +0 -0
  506. data/vendor/local/share/locale/es/LC_MESSAGES/cogl.mo +0 -0
  507. data/vendor/local/share/locale/es/LC_MESSAGES/json-glib-1.0.mo +0 -0
  508. data/vendor/local/share/locale/et/LC_MESSAGES/json-glib-1.0.mo +0 -0
  509. data/vendor/local/share/locale/eu/LC_MESSAGES/clutter-1.0.mo +0 -0
  510. data/vendor/local/share/locale/eu/LC_MESSAGES/cogl.mo +0 -0
  511. data/vendor/local/share/locale/eu/LC_MESSAGES/json-glib-1.0.mo +0 -0
  512. data/vendor/local/share/locale/fa/LC_MESSAGES/clutter-1.0.mo +0 -0
  513. data/vendor/local/share/locale/fa/LC_MESSAGES/cogl.mo +0 -0
  514. data/vendor/local/share/locale/fi/LC_MESSAGES/clutter-1.0.mo +0 -0
  515. data/vendor/local/share/locale/fr/LC_MESSAGES/clutter-1.0.mo +0 -0
  516. data/vendor/local/share/locale/fr/LC_MESSAGES/cogl.mo +0 -0
  517. data/vendor/local/share/locale/fr/LC_MESSAGES/json-glib-1.0.mo +0 -0
  518. data/vendor/local/share/locale/fur/LC_MESSAGES/json-glib-1.0.mo +0 -0
  519. data/vendor/local/share/locale/gl/LC_MESSAGES/clutter-1.0.mo +0 -0
  520. data/vendor/local/share/locale/gl/LC_MESSAGES/cogl.mo +0 -0
  521. data/vendor/local/share/locale/gl/LC_MESSAGES/json-glib-1.0.mo +0 -0
  522. data/vendor/local/share/locale/he/LC_MESSAGES/clutter-1.0.mo +0 -0
  523. data/vendor/local/share/locale/he/LC_MESSAGES/cogl.mo +0 -0
  524. data/vendor/local/share/locale/he/LC_MESSAGES/json-glib-1.0.mo +0 -0
  525. data/vendor/local/share/locale/hi/LC_MESSAGES/clutter-1.0.mo +0 -0
  526. data/vendor/local/share/locale/hi/LC_MESSAGES/cogl.mo +0 -0
  527. data/vendor/local/share/locale/hi/LC_MESSAGES/json-glib-1.0.mo +0 -0
  528. data/vendor/local/share/locale/hu/LC_MESSAGES/clutter-1.0.mo +0 -0
  529. data/vendor/local/share/locale/hu/LC_MESSAGES/cogl.mo +0 -0
  530. data/vendor/local/share/locale/hu/LC_MESSAGES/json-glib-1.0.mo +0 -0
  531. data/vendor/local/share/locale/id/LC_MESSAGES/clutter-1.0.mo +0 -0
  532. data/vendor/local/share/locale/id/LC_MESSAGES/cogl.mo +0 -0
  533. data/vendor/local/share/locale/id/LC_MESSAGES/json-glib-1.0.mo +0 -0
  534. data/vendor/local/share/locale/it/LC_MESSAGES/clutter-1.0.mo +0 -0
  535. data/vendor/local/share/locale/it/LC_MESSAGES/cogl.mo +0 -0
  536. data/vendor/local/share/locale/it/LC_MESSAGES/json-glib-1.0.mo +0 -0
  537. data/vendor/local/share/locale/ja/LC_MESSAGES/clutter-1.0.mo +0 -0
  538. data/vendor/local/share/locale/ja/LC_MESSAGES/cogl.mo +0 -0
  539. data/vendor/local/share/locale/ja/LC_MESSAGES/json-glib-1.0.mo +0 -0
  540. data/vendor/local/share/locale/km/LC_MESSAGES/clutter-1.0.mo +0 -0
  541. data/vendor/local/share/locale/km/LC_MESSAGES/cogl.mo +0 -0
  542. data/vendor/local/share/locale/kn/LC_MESSAGES/clutter-1.0.mo +0 -0
  543. data/vendor/local/share/locale/kn/LC_MESSAGES/cogl.mo +0 -0
  544. data/vendor/local/share/locale/ko/LC_MESSAGES/clutter-1.0.mo +0 -0
  545. data/vendor/local/share/locale/ko/LC_MESSAGES/cogl.mo +0 -0
  546. data/vendor/local/share/locale/ko/LC_MESSAGES/json-glib-1.0.mo +0 -0
  547. data/vendor/local/share/locale/ky/LC_MESSAGES/json-glib-1.0.mo +0 -0
  548. data/vendor/local/share/locale/lt/LC_MESSAGES/clutter-1.0.mo +0 -0
  549. data/vendor/local/share/locale/lt/LC_MESSAGES/cogl.mo +0 -0
  550. data/vendor/local/share/locale/lt/LC_MESSAGES/json-glib-1.0.mo +0 -0
  551. data/vendor/local/share/locale/lv/LC_MESSAGES/clutter-1.0.mo +0 -0
  552. data/vendor/local/share/locale/lv/LC_MESSAGES/cogl.mo +0 -0
  553. data/vendor/local/share/locale/lv/LC_MESSAGES/json-glib-1.0.mo +0 -0
  554. data/vendor/local/share/locale/mk/LC_MESSAGES/clutter-1.0.mo +0 -0
  555. data/vendor/local/share/locale/ml/LC_MESSAGES/clutter-1.0.mo +0 -0
  556. data/vendor/local/share/locale/ml/LC_MESSAGES/cogl.mo +0 -0
  557. data/vendor/local/share/locale/ml/LC_MESSAGES/json-glib-1.0.mo +0 -0
  558. data/vendor/local/share/locale/nb/LC_MESSAGES/clutter-1.0.mo +0 -0
  559. data/vendor/local/share/locale/nb/LC_MESSAGES/cogl.mo +0 -0
  560. data/vendor/local/share/locale/nb/LC_MESSAGES/json-glib-1.0.mo +0 -0
  561. data/vendor/local/share/locale/nl/LC_MESSAGES/clutter-1.0.mo +0 -0
  562. data/vendor/local/share/locale/nl/LC_MESSAGES/cogl.mo +0 -0
  563. data/vendor/local/share/locale/or/LC_MESSAGES/clutter-1.0.mo +0 -0
  564. data/vendor/local/share/locale/or/LC_MESSAGES/cogl.mo +0 -0
  565. data/vendor/local/share/locale/or/LC_MESSAGES/json-glib-1.0.mo +0 -0
  566. data/vendor/local/share/locale/pa/LC_MESSAGES/clutter-1.0.mo +0 -0
  567. data/vendor/local/share/locale/pa/LC_MESSAGES/cogl.mo +0 -0
  568. data/vendor/local/share/locale/pa/LC_MESSAGES/json-glib-1.0.mo +0 -0
  569. data/vendor/local/share/locale/pl/LC_MESSAGES/clutter-1.0.mo +0 -0
  570. data/vendor/local/share/locale/pl/LC_MESSAGES/cogl.mo +0 -0
  571. data/vendor/local/share/locale/pl/LC_MESSAGES/json-glib-1.0.mo +0 -0
  572. data/vendor/local/share/locale/ps/LC_MESSAGES/clutter-1.0.mo +0 -0
  573. data/vendor/local/share/locale/pt/LC_MESSAGES/clutter-1.0.mo +0 -0
  574. data/vendor/local/share/locale/pt/LC_MESSAGES/cogl.mo +0 -0
  575. data/vendor/local/share/locale/pt/LC_MESSAGES/json-glib-1.0.mo +0 -0
  576. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/clutter-1.0.mo +0 -0
  577. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/cogl.mo +0 -0
  578. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/json-glib-1.0.mo +0 -0
  579. data/vendor/local/share/locale/ro/LC_MESSAGES/clutter-1.0.mo +0 -0
  580. data/vendor/local/share/locale/ru/LC_MESSAGES/clutter-1.0.mo +0 -0
  581. data/vendor/local/share/locale/ru/LC_MESSAGES/cogl.mo +0 -0
  582. data/vendor/local/share/locale/ru/LC_MESSAGES/json-glib-1.0.mo +0 -0
  583. data/vendor/local/share/locale/sk/LC_MESSAGES/clutter-1.0.mo +0 -0
  584. data/vendor/local/share/locale/sk/LC_MESSAGES/cogl.mo +0 -0
  585. data/vendor/local/share/locale/sk/LC_MESSAGES/json-glib-1.0.mo +0 -0
  586. data/vendor/local/share/locale/sl/LC_MESSAGES/clutter-1.0.mo +0 -0
  587. data/vendor/local/share/locale/sl/LC_MESSAGES/cogl.mo +0 -0
  588. data/vendor/local/share/locale/sl/LC_MESSAGES/json-glib-1.0.mo +0 -0
  589. data/vendor/local/share/locale/sr/LC_MESSAGES/clutter-1.0.mo +0 -0
  590. data/vendor/local/share/locale/sr/LC_MESSAGES/cogl.mo +0 -0
  591. data/vendor/local/share/locale/sr/LC_MESSAGES/json-glib-1.0.mo +0 -0
  592. data/vendor/local/share/locale/sr@latin/LC_MESSAGES/clutter-1.0.mo +0 -0
  593. data/vendor/local/share/locale/sr@latin/LC_MESSAGES/cogl.mo +0 -0
  594. data/vendor/local/share/locale/sr@latin/LC_MESSAGES/json-glib-1.0.mo +0 -0
  595. data/vendor/local/share/locale/sv/LC_MESSAGES/clutter-1.0.mo +0 -0
  596. data/vendor/local/share/locale/sv/LC_MESSAGES/cogl.mo +0 -0
  597. data/vendor/local/share/locale/sv/LC_MESSAGES/json-glib-1.0.mo +0 -0
  598. data/vendor/local/share/locale/ta/LC_MESSAGES/clutter-1.0.mo +0 -0
  599. data/vendor/local/share/locale/ta/LC_MESSAGES/cogl.mo +0 -0
  600. data/vendor/local/share/locale/te/LC_MESSAGES/clutter-1.0.mo +0 -0
  601. data/vendor/local/share/locale/te/LC_MESSAGES/cogl.mo +0 -0
  602. data/vendor/local/share/locale/te/LC_MESSAGES/json-glib-1.0.mo +0 -0
  603. data/vendor/local/share/locale/tg/LC_MESSAGES/json-glib-1.0.mo +0 -0
  604. data/vendor/local/share/locale/th/LC_MESSAGES/cogl.mo +0 -0
  605. data/vendor/local/share/locale/tr/LC_MESSAGES/clutter-1.0.mo +0 -0
  606. data/vendor/local/share/locale/tr/LC_MESSAGES/cogl.mo +0 -0
  607. data/vendor/local/share/locale/tr/LC_MESSAGES/json-glib-1.0.mo +0 -0
  608. data/vendor/local/share/locale/ug/LC_MESSAGES/clutter-1.0.mo +0 -0
  609. data/vendor/local/share/locale/ug/LC_MESSAGES/cogl.mo +0 -0
  610. data/vendor/local/share/locale/ug/LC_MESSAGES/json-glib-1.0.mo +0 -0
  611. data/vendor/local/share/locale/uk/LC_MESSAGES/clutter-1.0.mo +0 -0
  612. data/vendor/local/share/locale/uk/LC_MESSAGES/cogl.mo +0 -0
  613. data/vendor/local/share/locale/uk/LC_MESSAGES/json-glib-1.0.mo +0 -0
  614. data/vendor/local/share/locale/ur/LC_MESSAGES/clutter-1.0.mo +0 -0
  615. data/vendor/local/share/locale/vi/LC_MESSAGES/cogl.mo +0 -0
  616. data/vendor/local/share/locale/vi/LC_MESSAGES/json-glib-1.0.mo +0 -0
  617. data/vendor/local/share/locale/yi/LC_MESSAGES/clutter-1.0.mo +0 -0
  618. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/clutter-1.0.mo +0 -0
  619. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/cogl.mo +0 -0
  620. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/json-glib-1.0.mo +0 -0
  621. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/clutter-1.0.mo +0 -0
  622. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/cogl.mo +0 -0
  623. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/json-glib-1.0.mo +0 -0
  624. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/clutter-1.0.mo +0 -0
  625. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/cogl.mo +0 -0
  626. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/json-glib-1.0.mo +0 -0
  627. data/vendor/local/share/man/man1/json-glib-format.1 +60 -0
  628. data/vendor/local/share/man/man1/json-glib-validate.1 +56 -0
  629. metadata +66 -27
  630. data/vendor/local/bin/libcogl-pango-15.dll +0 -0
  631. data/vendor/local/share/gtk-doc/html/json-glib/ch04.html +0 -38
data/vendor/local/share/gtk-doc/html/clutter/clutter-General.html CHANGED
@@ -8,15 +8,14 @@
8
8
  <link rel="up" href="ch10.html" title="General purpose API">
9
9
  <link rel="prev" href="ClutterInputDevice.html" title="ClutterInputDevice">
10
10
  <link rel="next" href="ClutterPath.html" title="ClutterPath">
11
- <meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
11
+ <meta name="generator" content="GTK-Doc V1.20.1 (XML mode)">
12
12
  <link rel="stylesheet" href="style.css" type="text/css">
13
13
  </head>
14
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="10"><tr valign="middle">
16
- <td width="100%" align="left">
17
- <a href="#" class="shortcut">Top</a>
18
-  | 
19
- <a href="#clutter-General.description" class="shortcut">Description</a>
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="#clutter-General.description" class="shortcut">Description</a></span>
20
19
  </td>
21
20
  <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
22
21
  <td><a accesskey="u" href="ch10.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
@@ -28,972 +27,579 @@
28
27
  <div class="refnamediv"><table width="100%"><tr>
29
28
  <td valign="top">
30
29
  <h2><span class="refentrytitle"><a name="clutter-General.top_of_page"></a>General</span></h2>
31
- <p>General — Various 'global' clutter functions.</p>
30
+ <p>General — Various 'global' Clutter functions.</p>
32
31
  </td>
33
- <td valign="top" align="right"></td>
32
+ <td class="gallery_image" valign="top" align="right"></td>
34
33
  </tr></table></div>
35
- <div class="refsynopsisdiv">
36
- <a name="clutter-General.synopsis"></a><h2>Synopsis</h2>
37
- <pre class="synopsis">#define <a class="link" href="clutter-General.html#CLUTTER-PRIORITY-REDRAW:CAPS" title="CLUTTER_PRIORITY_REDRAW">CLUTTER_PRIORITY_REDRAW</a>
38
-
39
- enum <a class="link" href="clutter-General.html#ClutterInitError" title="enum ClutterInitError">ClutterInitError</a>;
40
- <a class="link" href="clutter-General.html#ClutterInitError" title="enum ClutterInitError"><span class="returnvalue">ClutterInitError</span></a> <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()">clutter_init</a> (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
41
- <em class="parameter"><code><span class="type">char</span> ***argv</code></em>);
42
- <a class="link" href="clutter-General.html#ClutterInitError" title="enum ClutterInitError"><span class="returnvalue">ClutterInitError</span></a> <a class="link" href="clutter-General.html#clutter-init-with-args" title="clutter_init_with_args ()">clutter_init_with_args</a> (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
43
- <em class="parameter"><code><span class="type">char</span> ***argv</code></em>,
44
- <em class="parameter"><code>const <span class="type">char</span> *parameter_string</code></em>,
45
- <em class="parameter"><code><span class="type">GOptionEntry</span> *entries</code></em>,
46
- <em class="parameter"><code>const <span class="type">char</span> *translation_domain</code></em>,
47
- <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
48
- <span class="returnvalue">GOptionGroup</span> * <a class="link" href="clutter-General.html#clutter-get-option-group" title="clutter_get_option_group ()">clutter_get_option_group</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
49
- <span class="returnvalue">GOptionGroup</span> * <a class="link" href="clutter-General.html#clutter-get-option-group-without-init" title="clutter_get_option_group_without_init ()">clutter_get_option_group_without_init</a>
50
- (<em class="parameter"><code><span class="type">void</span></code></em>);
51
-
52
- <span class="returnvalue">void</span> <a class="link" href="clutter-General.html#clutter-main" title="clutter_main ()">clutter_main</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
53
- <span class="returnvalue">void</span> <a class="link" href="clutter-General.html#clutter-main-quit" title="clutter_main_quit ()">clutter_main_quit</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
54
- <span class="returnvalue">gint</span> <a class="link" href="clutter-General.html#clutter-main-level" title="clutter_main_level ()">clutter_main_level</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
55
-
56
- <span class="returnvalue">gboolean</span> <a class="link" href="clutter-General.html#clutter-get-debug-enabled" title="clutter_get_debug_enabled ()">clutter_get_debug_enabled</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
57
- <span class="returnvalue">gboolean</span> <a class="link" href="clutter-General.html#clutter-get-show-fps" title="clutter_get_show_fps ()">clutter_get_show_fps</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
58
- <span class="returnvalue">gulong</span> <a class="link" href="clutter-General.html#clutter-get-timestamp" title="clutter_get_timestamp ()">clutter_get_timestamp</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
59
- <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="returnvalue">ClutterActor</span></a> * <a class="link" href="clutter-General.html#clutter-get-actor-by-gid" title="clutter_get_actor_by_gid ()">clutter_get_actor_by_gid</a> (<em class="parameter"><code><span class="type">guint32</span> id_</code></em>);
60
- <span class="returnvalue">void</span> <a class="link" href="clutter-General.html#clutter-set-default-frame-rate" title="clutter_set_default_frame_rate ()">clutter_set_default_frame_rate</a> (<em class="parameter"><code><span class="type">guint</span> frames_per_sec</code></em>);
61
- <span class="returnvalue">guint</span> <a class="link" href="clutter-General.html#clutter-get-default-frame-rate" title="clutter_get_default_frame_rate ()">clutter_get_default_frame_rate</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
62
- <span class="returnvalue">void</span> <a class="link" href="clutter-General.html#clutter-set-motion-events-enabled" title="clutter_set_motion_events_enabled ()">clutter_set_motion_events_enabled</a> (<em class="parameter"><code><span class="type">gboolean</span> enable</code></em>);
63
- <span class="returnvalue">gboolean</span> <a class="link" href="clutter-General.html#clutter-get-motion-events-enabled" title="clutter_get_motion_events_enabled ()">clutter_get_motion_events_enabled</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
64
- <span class="returnvalue">void</span> <a class="link" href="clutter-General.html#clutter-clear-glyph-cache" title="clutter_clear_glyph_cache ()">clutter_clear_glyph_cache</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
65
- enum <a class="link" href="clutter-General.html#ClutterFontFlags" title="enum ClutterFontFlags">ClutterFontFlags</a>;
66
- <span class="returnvalue">void</span> <a class="link" href="clutter-General.html#clutter-set-font-flags" title="clutter_set_font_flags ()">clutter_set_font_flags</a> (<em class="parameter"><code><a class="link" href="clutter-General.html#ClutterFontFlags" title="enum ClutterFontFlags"><span class="type">ClutterFontFlags</span></a> flags</code></em>);
67
- <a class="link" href="clutter-General.html#ClutterFontFlags" title="enum ClutterFontFlags"><span class="returnvalue">ClutterFontFlags</span></a> <a class="link" href="clutter-General.html#clutter-get-font-flags" title="clutter_get_font_flags ()">clutter_get_font_flags</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
68
- <span class="returnvalue">PangoFontMap</span> * <a class="link" href="clutter-General.html#clutter-get-font-map" title="clutter_get_font_map ()">clutter_get_font_map</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
69
- enum <a class="link" href="clutter-General.html#ClutterTextDirection" title="enum ClutterTextDirection">ClutterTextDirection</a>;
70
- <a class="link" href="clutter-General.html#ClutterTextDirection" title="enum ClutterTextDirection"><span class="returnvalue">ClutterTextDirection</span></a> <a class="link" href="clutter-General.html#clutter-get-default-text-direction" title="clutter_get_default_text_direction ()">clutter_get_default_text_direction</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
71
- <span class="returnvalue">gboolean</span> <a class="link" href="clutter-General.html#clutter-get-accessibility-enabled" title="clutter_get_accessibility_enabled ()">clutter_get_accessibility_enabled</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
72
- <span class="returnvalue">void</span> <a class="link" href="clutter-General.html#clutter-disable-accessibility" title="clutter_disable_accessibility ()">clutter_disable_accessibility</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
73
-
74
- <span class="returnvalue">void</span> <a class="link" href="clutter-General.html#clutter-threads-set-lock-functions" title="clutter_threads_set_lock_functions ()">clutter_threads_set_lock_functions</a> (<em class="parameter"><code><span class="type">GCallback</span> enter_fn</code></em>,
75
- <em class="parameter"><code><span class="type">GCallback</span> leave_fn</code></em>);
76
- <span class="returnvalue">void</span> <a class="link" href="clutter-General.html#clutter-threads-init" title="clutter_threads_init ()">clutter_threads_init</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
77
- <span class="returnvalue">void</span> <a class="link" href="clutter-General.html#clutter-threads-enter" title="clutter_threads_enter ()">clutter_threads_enter</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
78
- <span class="returnvalue">void</span> <a class="link" href="clutter-General.html#clutter-threads-leave" title="clutter_threads_leave ()">clutter_threads_leave</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
79
- <span class="returnvalue">guint</span> <a class="link" href="clutter-General.html#clutter-threads-add-idle" title="clutter_threads_add_idle ()">clutter_threads_add_idle</a> (<em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
80
- <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);
81
- <span class="returnvalue">guint</span> <a class="link" href="clutter-General.html#clutter-threads-add-idle-full" title="clutter_threads_add_idle_full ()">clutter_threads_add_idle_full</a> (<em class="parameter"><code><span class="type">gint</span> priority</code></em>,
82
- <em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
83
- <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
84
- <em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);
85
- <span class="returnvalue">guint</span> <a class="link" href="clutter-General.html#clutter-threads-add-timeout" title="clutter_threads_add_timeout ()">clutter_threads_add_timeout</a> (<em class="parameter"><code><span class="type">guint</span> interval</code></em>,
86
- <em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
87
- <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);
88
- <span class="returnvalue">guint</span> <a class="link" href="clutter-General.html#clutter-threads-add-timeout-full" title="clutter_threads_add_timeout_full ()">clutter_threads_add_timeout_full</a> (<em class="parameter"><code><span class="type">gint</span> priority</code></em>,
89
- <em class="parameter"><code><span class="type">guint</span> interval</code></em>,
90
- <em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
91
- <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
92
- <em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);
93
- <span class="returnvalue">guint</span> <a class="link" href="clutter-General.html#clutter-threads-add-frame-source" title="clutter_threads_add_frame_source ()">clutter_threads_add_frame_source</a> (<em class="parameter"><code><span class="type">guint</span> fps</code></em>,
94
- <em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
95
- <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);
96
- <span class="returnvalue">guint</span> <a class="link" href="clutter-General.html#clutter-threads-add-frame-source-full" title="clutter_threads_add_frame_source_full ()">clutter_threads_add_frame_source_full</a>
97
- (<em class="parameter"><code><span class="type">gint</span> priority</code></em>,
98
- <em class="parameter"><code><span class="type">guint</span> fps</code></em>,
99
- <em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
100
- <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
101
- <em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);
102
- <span class="returnvalue">guint</span> <a class="link" href="clutter-General.html#clutter-threads-add-repaint-func" title="clutter_threads_add_repaint_func ()">clutter_threads_add_repaint_func</a> (<em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
103
- <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
104
- <em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);
105
- enum <a class="link" href="clutter-General.html#ClutterRepaintFlags" title="enum ClutterRepaintFlags">ClutterRepaintFlags</a>;
106
- <span class="returnvalue">guint</span> <a class="link" href="clutter-General.html#clutter-threads-add-repaint-func-full" title="clutter_threads_add_repaint_func_full ()">clutter_threads_add_repaint_func_full</a>
107
- (<em class="parameter"><code><a class="link" href="clutter-General.html#ClutterRepaintFlags" title="enum ClutterRepaintFlags"><span class="type">ClutterRepaintFlags</span></a> flags</code></em>,
108
- <em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
109
- <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
110
- <em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);
111
- <span class="returnvalue">void</span> <a class="link" href="clutter-General.html#clutter-threads-remove-repaint-func" title="clutter_threads_remove_repaint_func ()">clutter_threads_remove_repaint_func</a> (<em class="parameter"><code><span class="type">guint</span> handle_id</code></em>);
112
-
113
- <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="returnvalue">ClutterActor</span></a> * <a class="link" href="clutter-General.html#clutter-get-keyboard-grab" title="clutter_get_keyboard_grab ()">clutter_get_keyboard_grab</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
114
- <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="returnvalue">ClutterActor</span></a> * <a class="link" href="clutter-General.html#clutter-get-pointer-grab" title="clutter_get_pointer_grab ()">clutter_get_pointer_grab</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
115
- <span class="returnvalue">void</span> <a class="link" href="clutter-General.html#clutter-grab-keyboard" title="clutter_grab_keyboard ()">clutter_grab_keyboard</a> (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>);
116
- <span class="returnvalue">void</span> <a class="link" href="clutter-General.html#clutter-grab-pointer" title="clutter_grab_pointer ()">clutter_grab_pointer</a> (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>);
117
- <span class="returnvalue">void</span> <a class="link" href="clutter-General.html#clutter-ungrab-keyboard" title="clutter_ungrab_keyboard ()">clutter_ungrab_keyboard</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
118
- <span class="returnvalue">void</span> <a class="link" href="clutter-General.html#clutter-ungrab-pointer" title="clutter_ungrab_pointer ()">clutter_ungrab_pointer</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
119
- <span class="returnvalue">void</span> <a class="link" href="clutter-General.html#clutter-grab-pointer-for-device" title="clutter_grab_pointer_for_device ()">clutter_grab_pointer_for_device</a> (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>,
120
- <em class="parameter"><code><span class="type">gint</span> id_</code></em>);
121
- <span class="returnvalue">void</span> <a class="link" href="clutter-General.html#clutter-ungrab-pointer-for-device" title="clutter_ungrab_pointer_for_device ()">clutter_ungrab_pointer_for_device</a> (<em class="parameter"><code><span class="type">gint</span> id_</code></em>);
122
-
123
- <span class="returnvalue">void</span> <a class="link" href="clutter-General.html#clutter-do-event" title="clutter_do_event ()">clutter_do_event</a> (<em class="parameter"><code><a class="link" href="clutter-Events.html#ClutterEvent" title="union ClutterEvent"><span class="type">ClutterEvent</span></a> *event</code></em>);
124
- </pre>
125
- </div>
126
- <div class="refsect1">
127
- <a name="clutter-General.description"></a><h2>Description</h2>
128
- <p>
129
- Functions to retrieve various global Clutter resources and other utility
130
- functions for mainloops, events and threads
131
- </p>
132
- <p>
133
- </p>
134
- <div class="refsect2">
135
- <a name="clutter-Threading-Model"></a><h3>Threading Model</h3>
136
- <p>Clutter is <span class="emphasis"><em>thread-aware</em></span>: all operations
137
- performed by Clutter are assumed to be under the big Clutter lock,
138
- which is created when the threading is initialized through
139
- <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a>.</p>
140
- <div class="example">
141
- <a name="example-Thread-Init"></a><p class="title"><b>Example 9. Thread Initialization</b></p>
142
- <div class="example-contents">
143
- <p>The code below shows how to correctly initialize Clutter
144
- in a multi-threaded environment. These operations are mandatory for
145
- applications that wish to use threads with Clutter.</p>
146
- <pre class="programlisting">
147
- int
148
- main (int argc, char *argv[])
149
- {
150
- /* initialize Clutter */
151
- clutter_init (&amp;argc, &amp;argv);
152
-
153
- /* program code */
154
-
155
- /* acquire the main lock */
156
- clutter_threads_enter ();
157
-
158
- /* start the main loop */
159
- clutter_main ();
160
-
161
- /* release the main lock */
162
- clutter_threads_leave ();
163
-
164
- /* clean up */
165
- return 0;
166
- }
167
- </pre>
168
- </div>
169
- </div>
170
- <br class="example-break"><p>This threading model has the caveat that it is only safe to call
171
- Clutter's API when the lock has been acquired — which happens
172
- between pairs of <a class="link" href="clutter-General.html#clutter-threads-enter" title="clutter_threads_enter ()"><code class="function">clutter_threads_enter()</code></a> and <a class="link" href="clutter-General.html#clutter-threads-leave" title="clutter_threads_leave ()"><code class="function">clutter_threads_leave()</code></a>
173
- calls.</p>
174
- <p>The only safe and portable way to use the Clutter API in a
175
- multi-threaded environment is to never access the API from a thread that
176
- did not call <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a> and <a class="link" href="clutter-General.html#clutter-main" title="clutter_main ()"><code class="function">clutter_main()</code></a>.</p>
177
- <p>The common pattern for using threads with Clutter is to use worker
178
- threads to perform blocking operations and then install idle or timeout
179
- sources with the result when the thread finished.</p>
180
- <p>Clutter provides thread-aware variants of <code class="function">g_idle_add()</code> and
181
- <code class="function">g_timeout_add()</code> that acquire the Clutter lock before invoking the provided
182
- callback: <a class="link" href="clutter-General.html#clutter-threads-add-idle" title="clutter_threads_add_idle ()"><code class="function">clutter_threads_add_idle()</code></a> and
183
- <a class="link" href="clutter-General.html#clutter-threads-add-timeout" title="clutter_threads_add_timeout ()"><code class="function">clutter_threads_add_timeout()</code></a>.</p>
184
- <p>The example below shows how to use a worker thread to perform a
185
- blocking operation, and perform UI updates using the main loop.</p>
186
- <div class="example">
187
- <a name="worker-thread-example"></a><p class="title"><b>Example 10. A worker thread example</b></p>
188
- <div class="example-contents">
189
- <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
190
- <tbody>
191
- <tr>
192
- <td class="listing_lines" align="right"><pre>1
193
- 2
194
- 3
195
- 4
196
- 5
197
- 6
198
- 7
199
- 8
200
- 9
201
- 10
202
- 11
203
- 12
204
- 13
205
- 14
206
- 15
207
- 16
208
- 17
209
- 18
210
- 19
211
- 20
212
- 21
213
- 22
214
- 23
215
- 24
216
- 25
217
- 26
218
- 27
219
- 28
220
- 29
221
- 30
222
- 31
223
- 32
224
- 33
225
- 34
226
- 35
227
- 36
228
- 37
229
- 38
230
- 39
231
- 40
232
- 41
233
- 42
234
- 43
235
- 44
236
- 45
237
- 46
238
- 47
239
- 48
240
- 49
241
- 50
242
- 51
243
- 52
244
- 53
245
- 54
246
- 55
247
- 56
248
- 57
249
- 58
250
- 59
251
- 60
252
- 61
253
- 62
254
- 63
255
- 64
256
- 65
257
- 66
258
- 67
259
- 68
260
- 69
261
- 70
262
- 71
263
- 72
264
- 73
265
- 74
266
- 75
267
- 76
268
- 77
269
- 78
270
- 79
271
- 80
272
- 81
273
- 82
274
- 83
275
- 84
276
- 85
277
- 86
278
- 87
279
- 88
280
- 89
281
- 90
282
- 91
283
- 92
284
- 93
285
- 94
286
- 95
287
- 96
288
- 97
289
- 98
290
- 99
291
- 100
292
- 101
293
- 102
294
- 103
295
- 104
296
- 105
297
- 106
298
- 107
299
- 108
300
- 109
301
- 110
302
- 111
303
- 112
304
- 113
305
- 114
306
- 115
307
- 116
308
- 117
309
- 118
310
- 119
311
- 120
312
- 121
313
- 122
314
- 123
315
- 124
316
- 125
317
- 126
318
- 127
319
- 128
320
- 129
321
- 130
322
- 131
323
- 132
324
- 133
325
- 134
326
- 135
327
- 136
328
- 137
329
- 138
330
- 139
331
- 140
332
- 141
333
- 142
334
- 143
335
- 144
336
- 145
337
- 146
338
- 147
339
- 148
340
- 149
341
- 150
342
- 151
343
- 152
344
- 153
345
- 154
346
- 155
347
- 156
348
- 157
349
- 158
350
- 159
351
- 160
352
- 161
353
- 162
354
- 163
355
- 164
356
- 165
357
- 166
358
- 167
359
- 168
360
- 169
361
- 170
362
- 171
363
- 172
364
- 173
365
- 174
366
- 175
367
- 176
368
- 177
369
- 178
370
- 179
371
- 180
372
- 181
373
- 182
374
- 183
375
- 184
376
- 185
377
- 186
378
- 187
379
- 188
380
- 189
381
- 190
382
- 191
383
- 192
384
- 193
385
- 194
386
- 195
387
- 196
388
- 197
389
- 198
390
- 199
391
- 200
392
- 201
393
- 202
394
- 203
395
- 204
396
- 205
397
- 206
398
- 207
399
- 208
400
- 209
401
- 210
402
- 211
403
- 212
404
- 213
405
- 214
406
- 215
407
- 216
408
- 217
409
- 218
410
- 219
411
- 220
412
- 221
413
- 222
414
- 223
415
- 224
416
- 225
417
- 226
418
- 227
419
- 228
420
- 229
421
- 230
422
- 231
423
- 232
424
- 233
425
- 234
426
- 235
427
- 236
428
- 237
429
- 238
430
- 239
431
- 240
432
- 241
433
- 242
434
- 243
435
- 244
436
- 245
437
- 246
438
- 247
439
- 248
440
- 249
441
- 250
442
- 251
443
- 252
444
- 253
445
- 254
446
- 255
447
- 256
448
- 257
449
- 258
450
- 259
451
- 260
452
- 261
453
- 262
454
- 263
455
- 264
456
- 265
457
- 266
458
- 267
459
- 268
460
- 269
461
- 270
462
- 271
463
- 272
464
- 273
465
- 274
466
- 275
467
- 276
468
- 277
469
- 278
470
- 279
471
- 280
472
- 281
473
- 282
474
- 283
475
- 284
476
- 285
477
- 286
478
- 287
479
- 288
480
- 289
481
- 290
482
- 291
483
- 292</pre></td>
484
- <td class="listing_code"><pre class="programlisting"><span class="preproc">#include</span><span class="normal"> </span><span class="string">&lt;stdio.h&gt;</span>
485
- <span class="preproc">#include</span><span class="normal"> </span><span class="string">&lt;stdlib.h&gt;</span>
486
- <span class="preproc">#include</span><span class="normal"> </span><span class="string">&lt;clutter/clutter.h&gt;</span>
487
-
488
- <span class="comment">/* our thread-specific data */</span>
489
- <span class="keyword">typedef</span><span class="normal"> </span><span class="keyword">struct</span>
490
- <span class="cbracket">{</span>
491
- <span class="normal"> </span><span class="usertype">ClutterActor</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">stage</span><span class="symbol">;</span>
492
- <span class="normal"> </span><span class="usertype">ClutterActor</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">label</span><span class="symbol">;</span>
493
- <span class="normal"> </span><span class="usertype">ClutterActor</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">progress</span><span class="symbol">;</span>
494
- <span class="normal"> </span><span class="usertype">ClutterActor</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">rect</span><span class="symbol">;</span>
495
-
496
- <span class="normal"> </span><span class="usertype">ClutterTransition</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">flip</span><span class="symbol">;</span>
497
- <span class="normal"> </span><span class="usertype">ClutterTransition</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">bounce</span><span class="symbol">;</span>
498
- <span class="cbracket">}</span><span class="normal"> TestThreadData</span><span class="symbol">;</span>
499
-
500
- <span class="keyword">static</span><span class="normal"> TestThreadData </span><span class="symbol">*</span>
501
- <span class="function">test_thread_data_new</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
502
- <span class="cbracket">{</span>
503
- <span class="normal"> </span><span class="usertype">TestThreadData</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">data</span><span class="symbol">;</span>
504
-
505
- <span class="normal"> data </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_new0</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">TestThreadData</span><span class="symbol">,</span><span class="normal"> </span><span class="number">1</span><span class="symbol">);</span>
506
-
507
- <span class="normal"> </span><span class="keyword">return</span><span class="normal"> data</span><span class="symbol">;</span>
508
- <span class="cbracket">}</span>
509
-
510
- <span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
511
- <span class="function">test_thread_data_free</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal"> _data</span><span class="symbol">)</span>
512
- <span class="cbracket">{</span>
513
- <span class="normal"> </span><span class="usertype">TestThreadData</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">data </span><span class="symbol">=</span><span class="normal"> _data</span><span class="symbol">;</span>
514
-
515
- <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data </span><span class="symbol">==</span><span class="normal"> NULL</span><span class="symbol">)</span>
516
- <span class="normal"> </span><span class="keyword">return</span><span class="symbol">;</span>
517
-
518
- <span class="normal"> </span><span class="function">g_print</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Removing thread data [%p]</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span><span class="normal"> _data</span><span class="symbol">);</span>
519
-
520
- <span class="normal"> </span><span class="function">g_clear_object</span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data</span><span class="symbol">-&gt;</span><span class="normal">progress</span><span class="symbol">);</span>
521
- <span class="normal"> </span><span class="function">g_clear_object</span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data</span><span class="symbol">-&gt;</span><span class="normal">label</span><span class="symbol">);</span>
522
- <span class="normal"> </span><span class="function">g_clear_object</span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data</span><span class="symbol">-&gt;</span><span class="normal">stage</span><span class="symbol">);</span>
523
- <span class="normal"> </span><span class="function">g_clear_object</span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data</span><span class="symbol">-&gt;</span><span class="normal">rect</span><span class="symbol">);</span>
524
- <span class="normal"> </span><span class="function">g_clear_object</span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data</span><span class="symbol">-&gt;</span><span class="normal">flip</span><span class="symbol">);</span>
525
- <span class="normal"> </span><span class="function">g_clear_object</span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data</span><span class="symbol">-&gt;</span><span class="normal">bounce</span><span class="symbol">);</span>
526
-
527
- <span class="normal"> </span><span class="function">g_free</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data</span><span class="symbol">);</span>
528
- <span class="cbracket">}</span>
529
-
530
- <span class="keyword">static</span><span class="normal"> gboolean</span>
531
- <span class="function">test_thread_done_idle</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal"> user_data</span><span class="symbol">)</span>
532
- <span class="cbracket">{</span>
533
- <span class="normal"> </span><span class="usertype">TestThreadData</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">data </span><span class="symbol">=</span><span class="normal"> user_data</span><span class="symbol">;</span>
534
-
535
- <span class="normal"> </span><span class="function">g_print</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Last update [%p]</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span><span class="normal"> data</span><span class="symbol">);</span>
536
-
537
- <span class="normal"> </span><span class="function"><a href="ClutterText.html#clutter-text-set-text">clutter_text_set_text</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">CLUTTER_TEXT</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data</span><span class="symbol">-&gt;</span><span class="normal">label</span><span class="symbol">),</span><span class="normal"> </span><span class="string">"Completed"</span><span class="symbol">);</span>
538
-
539
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-remove-transition">clutter_actor_remove_transition</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data</span><span class="symbol">-&gt;</span><span class="normal">rect</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"bounce"</span><span class="symbol">);</span>
540
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-remove-transition">clutter_actor_remove_transition</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data</span><span class="symbol">-&gt;</span><span class="normal">rect</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"flip"</span><span class="symbol">);</span>
541
-
542
- <span class="normal"> </span><span class="keyword">return</span><span class="normal"> G_SOURCE_REMOVE</span><span class="symbol">;</span>
543
- <span class="cbracket">}</span>
544
-
545
- <span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
546
- <span class="function">test_thread_data_done</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal"> _data</span><span class="symbol">)</span>
547
- <span class="cbracket">{</span>
548
- <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">_data </span><span class="symbol">==</span><span class="normal"> NULL</span><span class="symbol">)</span>
549
- <span class="normal"> </span><span class="keyword">return</span><span class="symbol">;</span>
550
-
551
- <span class="normal"> </span><span class="function">g_print</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Thread completed</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">);</span>
552
-
553
- <span class="normal"> </span><span class="comment">/* since the TestThreadData structure references Clutter data structures</span>
554
- <span class="comment"> * we need to free it from within the same thread that called clutter_main()</span>
555
- <span class="comment"> * which means using an idle handler in the main loop.</span>
556
- <span class="comment"> *</span>
557
- <span class="comment"> * clutter_threads_add_idle() is guaranteed to run the callback passed to</span>
558
- <span class="comment"> * to it under the Big Clutter Lock.</span>
559
- <span class="comment"> */</span>
560
- <span class="normal"> </span><span class="function"><a href="clutter-General.html#clutter-threads-add-idle-full">clutter_threads_add_idle_full</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">G_PRIORITY_DEFAULT</span><span class="symbol">,</span>
561
- <span class="normal"> test_thread_done_idle</span><span class="symbol">,</span>
562
- <span class="normal"> _data</span><span class="symbol">,</span>
563
- <span class="normal"> test_thread_data_free</span><span class="symbol">);</span>
564
- <span class="cbracket">}</span>
565
-
566
- <span class="comment">/* thread local storage */</span>
567
- <span class="keyword">static</span><span class="normal"> </span><span class="usertype">GPrivate</span><span class="normal"> test_thread_data </span><span class="symbol">=</span><span class="normal"> </span><span class="function">G_PRIVATE_INIT</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">test_thread_data_done</span><span class="symbol">);</span>
568
-
569
- <span class="keyword">typedef</span><span class="normal"> </span><span class="keyword">struct</span><span class="normal"> </span><span class="cbracket">{</span>
570
- <span class="normal"> </span><span class="usertype">gint</span><span class="normal"> count</span><span class="symbol">;</span>
571
- <span class="normal"> </span><span class="usertype">TestThreadData</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">thread_data</span><span class="symbol">;</span>
572
- <span class="cbracket">}</span><span class="normal"> TestUpdate</span><span class="symbol">;</span>
573
-
574
- <span class="keyword">static</span><span class="normal"> gboolean</span>
575
- <span class="function">update_label_idle</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">)</span>
576
- <span class="cbracket">{</span>
577
- <span class="normal"> </span><span class="usertype">TestUpdate</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">update </span><span class="symbol">=</span><span class="normal"> data</span><span class="symbol">;</span>
578
- <span class="normal"> </span><span class="usertype">guint</span><span class="normal"> width</span><span class="symbol">;</span>
579
- <span class="normal"> </span><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">text</span><span class="symbol">;</span>
580
-
581
- <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">update</span><span class="symbol">-&gt;</span><span class="normal">thread_data</span><span class="symbol">-&gt;</span><span class="normal">label </span><span class="symbol">==</span><span class="normal"> NULL</span><span class="symbol">)</span>
582
- <span class="normal"> </span><span class="keyword">return</span><span class="normal"> G_SOURCE_REMOVE</span><span class="symbol">;</span>
583
-
584
- <span class="normal"> text </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_strdup_printf</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Count to %d"</span><span class="symbol">,</span><span class="normal"> update</span><span class="symbol">-&gt;</span><span class="normal">count</span><span class="symbol">);</span>
585
- <span class="normal"> </span><span class="function"><a href="ClutterText.html#clutter-text-set-text">clutter_text_set_text</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">CLUTTER_TEXT</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">update</span><span class="symbol">-&gt;</span><span class="normal">thread_data</span><span class="symbol">-&gt;</span><span class="normal">label</span><span class="symbol">),</span><span class="normal"> text</span><span class="symbol">);</span>
586
-
587
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-set-width">clutter_actor_set_width</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">update</span><span class="symbol">-&gt;</span><span class="normal">thread_data</span><span class="symbol">-&gt;</span><span class="normal">label</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">-</span><span class="number">1</span><span class="symbol">);</span>
588
-
589
- <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">update</span><span class="symbol">-&gt;</span><span class="normal">count </span><span class="symbol">==</span><span class="normal"> </span><span class="number">0</span><span class="symbol">)</span>
590
- <span class="normal"> width </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
591
- <span class="normal"> </span><span class="keyword">else</span><span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">update</span><span class="symbol">-&gt;</span><span class="normal">count </span><span class="symbol">==</span><span class="normal"> </span><span class="number">100</span><span class="symbol">)</span>
592
- <span class="normal"> width </span><span class="symbol">=</span><span class="normal"> </span><span class="number">350</span><span class="symbol">;</span>
593
- <span class="normal"> </span><span class="keyword">else</span>
594
- <span class="normal"> width </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">guint</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">update</span><span class="symbol">-&gt;</span><span class="normal">count </span><span class="symbol">/</span><span class="normal"> </span><span class="number">100.0</span><span class="normal"> </span><span class="symbol">*</span><span class="normal"> </span><span class="number">350.0</span><span class="symbol">);</span>
595
-
596
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-save-easing-state">clutter_actor_save_easing_state</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">update</span><span class="symbol">-&gt;</span><span class="normal">thread_data</span><span class="symbol">-&gt;</span><span class="normal">progress</span><span class="symbol">);</span>
597
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-set-width">clutter_actor_set_width</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">update</span><span class="symbol">-&gt;</span><span class="normal">thread_data</span><span class="symbol">-&gt;</span><span class="normal">progress</span><span class="symbol">,</span><span class="normal"> width</span><span class="symbol">);</span>
598
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-restore-easing-state">clutter_actor_restore_easing_state</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">update</span><span class="symbol">-&gt;</span><span class="normal">thread_data</span><span class="symbol">-&gt;</span><span class="normal">progress</span><span class="symbol">);</span>
599
-
600
- <span class="normal"> </span><span class="function">g_free</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">text</span><span class="symbol">);</span>
601
- <span class="normal"> </span><span class="function">g_free</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">update</span><span class="symbol">);</span>
602
-
603
- <span class="normal"> </span><span class="keyword">return</span><span class="normal"> G_SOURCE_REMOVE</span><span class="symbol">;</span>
604
- <span class="cbracket">}</span>
605
-
606
- <span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
607
- <span class="function">do_something_very_slow</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
608
- <span class="cbracket">{</span>
609
- <span class="normal"> </span><span class="usertype">TestThreadData</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">data</span><span class="symbol">;</span>
610
- <span class="normal"> </span><span class="usertype">gint</span><span class="normal"> i</span><span class="symbol">;</span>
611
-
612
- <span class="normal"> data </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_private_get</span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">test_thread_data</span><span class="symbol">);</span>
613
-
614
- <span class="normal"> </span><span class="keyword">for</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">i </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span><span class="normal"> i </span><span class="symbol">&lt;=</span><span class="normal"> </span><span class="number">100</span><span class="symbol">;</span><span class="normal"> i</span><span class="symbol">++)</span>
615
- <span class="normal"> </span><span class="cbracket">{</span>
616
- <span class="normal"> </span><span class="usertype">gint</span><span class="normal"> msecs</span><span class="symbol">;</span>
617
-
618
- <span class="normal"> msecs </span><span class="symbol">=</span><span class="normal"> </span><span class="number">1</span><span class="normal"> </span><span class="symbol">+</span><span class="normal"> </span><span class="symbol">(</span><span class="type">int</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">(</span><span class="number">100.0</span><span class="normal"> </span><span class="symbol">*</span><span class="normal"> </span><span class="function">rand</span><span class="normal"> </span><span class="symbol">()</span><span class="normal"> </span><span class="symbol">/</span><span class="normal"> </span><span class="symbol">((</span><span class="normal">RAND_MAX </span><span class="symbol">+</span><span class="normal"> </span><span class="number">1.0</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">/</span><span class="normal"> </span><span class="number">3</span><span class="symbol">));</span>
619
-
620
- <span class="normal"> </span><span class="comment">/* sleep for a while, to emulate some work being done */</span>
621
- <span class="normal"> </span><span class="function">g_usleep</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">msecs </span><span class="symbol">*</span><span class="normal"> </span><span class="number">1000</span><span class="symbol">);</span>
622
-
623
- <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">((</span><span class="normal">i </span><span class="symbol">%</span><span class="normal"> </span><span class="number">10</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">==</span><span class="normal"> </span><span class="number">0</span><span class="symbol">)</span>
624
- <span class="normal"> </span><span class="cbracket">{</span>
625
- <span class="normal"> </span><span class="usertype">TestUpdate</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">update</span><span class="symbol">;</span>
626
-
627
- <span class="normal"> </span><span class="comment">/* update the UI from within the main loop, making sure that the</span>
628
- <span class="comment"> * Big Clutter Lock is held; only one thread at a time can call</span>
629
- <span class="comment"> * Clutter API, and it's mandatory to do this from the same thread</span>
630
- <span class="comment"> * that called clutter_init()/clutter_main().</span>
631
- <span class="comment"> */</span>
632
- <span class="normal"> update </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_new</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">TestUpdate</span><span class="symbol">,</span><span class="normal"> </span><span class="number">1</span><span class="symbol">);</span>
633
- <span class="normal"> update</span><span class="symbol">-&gt;</span><span class="normal">count </span><span class="symbol">=</span><span class="normal"> i</span><span class="symbol">;</span>
634
- <span class="normal"> update</span><span class="symbol">-&gt;</span><span class="normal">thread_data </span><span class="symbol">=</span><span class="normal"> data</span><span class="symbol">;</span>
635
-
636
- <span class="normal"> </span><span class="function"><a href="clutter-General.html#clutter-threads-add-idle-full">clutter_threads_add_idle_full</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">G_PRIORITY_HIGH</span><span class="symbol">,</span>
637
- <span class="normal"> update_label_idle</span><span class="symbol">,</span>
638
- <span class="normal"> update</span><span class="symbol">,</span><span class="normal"> NULL</span><span class="symbol">);</span>
639
- <span class="normal"> </span><span class="cbracket">}</span>
640
- <span class="normal"> </span><span class="cbracket">}</span>
641
- <span class="cbracket">}</span>
642
-
643
- <span class="keyword">static</span><span class="normal"> gpointer</span>
644
- <span class="function">test_thread_func</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal"> user_data</span><span class="symbol">)</span>
645
- <span class="cbracket">{</span>
646
- <span class="normal"> </span><span class="usertype">TestThreadData</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">data </span><span class="symbol">=</span><span class="normal"> user_data</span><span class="symbol">;</span>
647
-
648
- <span class="normal"> </span><span class="function">g_private_set</span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">test_thread_data</span><span class="symbol">,</span><span class="normal"> data</span><span class="symbol">);</span>
649
-
650
- <span class="normal"> </span><span class="comment">/* this function will block */</span>
651
- <span class="normal"> </span><span class="function">do_something_very_slow</span><span class="normal"> </span><span class="symbol">();</span>
652
-
653
- <span class="normal"> </span><span class="keyword">return</span><span class="normal"> NULL</span><span class="symbol">;</span>
654
- <span class="cbracket">}</span>
655
-
656
- <span class="keyword">static</span><span class="normal"> </span><span class="usertype">ClutterActor</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">count_label </span><span class="symbol">=</span><span class="normal"> NULL</span><span class="symbol">;</span>
657
- <span class="keyword">static</span><span class="normal"> </span><span class="usertype">ClutterActor</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">help_label </span><span class="symbol">=</span><span class="normal"> NULL</span><span class="symbol">;</span>
658
- <span class="keyword">static</span><span class="normal"> </span><span class="usertype">ClutterActor</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">progress_rect </span><span class="symbol">=</span><span class="normal"> NULL</span><span class="symbol">;</span>
659
- <span class="keyword">static</span><span class="normal"> </span><span class="usertype">ClutterActor</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">rect </span><span class="symbol">=</span><span class="normal"> NULL</span><span class="symbol">;</span>
660
- <span class="keyword">static</span><span class="normal"> </span><span class="usertype">ClutterTransition</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">flip </span><span class="symbol">=</span><span class="normal"> NULL</span><span class="symbol">;</span>
661
- <span class="keyword">static</span><span class="normal"> </span><span class="usertype">ClutterTransition</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">bounce </span><span class="symbol">=</span><span class="normal"> NULL</span><span class="symbol">;</span>
662
-
663
- <span class="keyword">static</span><span class="normal"> gboolean</span>
664
- <span class="function">on_key_press_event</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">ClutterStage</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">stage</span><span class="symbol">,</span>
665
- <span class="normal"> </span><span class="usertype">ClutterEvent</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">event</span><span class="symbol">,</span>
666
- <span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> user_data</span><span class="symbol">)</span>
667
- <span class="cbracket">{</span>
668
- <span class="normal"> </span><span class="usertype">TestThreadData</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">data</span><span class="symbol">;</span>
669
-
670
- <span class="normal"> </span><span class="keyword">switch</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="clutter-Events.html#clutter-event-get-key-symbol">clutter_event_get_key_symbol</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event</span><span class="symbol">))</span>
671
- <span class="normal"> </span><span class="cbracket">{</span>
672
- <span class="normal"> </span><span class="keyword">case</span><span class="normal"> CLUTTER_KEY_s</span><span class="symbol">:</span>
673
- <span class="normal"> </span><span class="function"><a href="ClutterText.html#clutter-text-set-text">clutter_text_set_text</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">CLUTTER_TEXT</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">help_label</span><span class="symbol">),</span><span class="normal"> </span><span class="string">"Press 'q' to quit"</span><span class="symbol">);</span>
674
-
675
- <span class="normal"> </span><span class="comment">/* start the animations */</span>
676
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-add-transition">clutter_actor_add_transition</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">rect</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"flip"</span><span class="symbol">,</span><span class="normal"> flip</span><span class="symbol">);</span>
677
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-add-transition">clutter_actor_add_transition</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">rect</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"bounce"</span><span class="symbol">,</span><span class="normal"> bounce</span><span class="symbol">);</span>
678
-
679
- <span class="normal"> </span><span class="comment">/* the data structure holding all our objects */</span>
680
- <span class="normal"> data </span><span class="symbol">=</span><span class="normal"> </span><span class="function">test_thread_data_new</span><span class="normal"> </span><span class="symbol">();</span>
681
- <span class="normal"> data</span><span class="symbol">-&gt;</span><span class="normal">stage </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_object_ref</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stage</span><span class="symbol">);</span>
682
- <span class="normal"> data</span><span class="symbol">-&gt;</span><span class="normal">label </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_object_ref</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">count_label</span><span class="symbol">);</span>
683
- <span class="normal"> data</span><span class="symbol">-&gt;</span><span class="normal">progress </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_object_ref</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">progress_rect</span><span class="symbol">);</span>
684
- <span class="normal"> data</span><span class="symbol">-&gt;</span><span class="normal">rect </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_object_ref</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">rect</span><span class="symbol">);</span>
685
- <span class="normal"> data</span><span class="symbol">-&gt;</span><span class="normal">flip </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_object_ref</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">flip</span><span class="symbol">);</span>
686
- <span class="normal"> data</span><span class="symbol">-&gt;</span><span class="normal">bounce </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_object_ref</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">bounce</span><span class="symbol">);</span>
687
-
688
- <span class="normal"> </span><span class="comment">/* start the thread that updates the counter and the progress bar */</span>
689
- <span class="normal"> </span><span class="function">g_thread_new</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"counter"</span><span class="symbol">,</span><span class="normal"> test_thread_func</span><span class="symbol">,</span><span class="normal"> data</span><span class="symbol">);</span>
690
-
691
- <span class="normal"> </span><span class="keyword">return</span><span class="normal"> <a href="clutter-Events.html#CLUTTER-EVENT-STOP:CAPS">CLUTTER_EVENT_STOP</a></span><span class="symbol">;</span>
692
-
693
- <span class="normal"> </span><span class="keyword">case</span><span class="normal"> CLUTTER_KEY_q</span><span class="symbol">:</span>
694
- <span class="normal"> </span><span class="function"><a href="clutter-General.html#clutter-main-quit">clutter_main_quit</a></span><span class="normal"> </span><span class="symbol">();</span>
695
-
696
- <span class="normal"> </span><span class="keyword">return</span><span class="normal"> <a href="clutter-Events.html#CLUTTER-EVENT-STOP:CAPS">CLUTTER_EVENT_STOP</a></span><span class="symbol">;</span>
697
-
698
- <span class="label"> default:</span>
699
- <span class="normal"> </span><span class="keyword">break</span><span class="symbol">;</span>
700
- <span class="normal"> </span><span class="cbracket">}</span>
701
-
702
- <span class="normal"> </span><span class="keyword">return</span><span class="normal"> <a href="clutter-Events.html#CLUTTER-EVENT-PROPAGATE:CAPS">CLUTTER_EVENT_PROPAGATE</a></span><span class="symbol">;</span>
703
- <span class="cbracket">}</span>
704
-
705
- <span class="type">int</span>
706
- <span class="function">main</span><span class="normal"> </span><span class="symbol">(</span><span class="type">int</span><span class="normal"> argc</span><span class="symbol">,</span><span class="normal"> </span><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">argv</span><span class="symbol">[])</span>
707
- <span class="cbracket">{</span>
708
- <span class="normal"> </span><span class="usertype">ClutterTransition</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">transition</span><span class="symbol">;</span>
709
- <span class="normal"> </span><span class="usertype">ClutterActor</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">stage</span><span class="symbol">;</span>
710
- <span class="normal"> </span><span class="usertype">ClutterPoint</span><span class="normal"> start </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="clutter-Base-geometric-types.html#CLUTTER-POINT-INIT:CAPS">CLUTTER_POINT_INIT</a></span><span class="normal"> </span><span class="symbol">(</span><span class="number">75</span><span class="symbol">.</span><span class="normal">f</span><span class="symbol">,</span><span class="normal"> </span><span class="number">150</span><span class="symbol">.</span><span class="normal">f</span><span class="symbol">);</span>
711
- <span class="normal"> </span><span class="usertype">ClutterPoint</span><span class="normal"> end </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="clutter-Base-geometric-types.html#CLUTTER-POINT-INIT:CAPS">CLUTTER_POINT_INIT</a></span><span class="normal"> </span><span class="symbol">(</span><span class="number">400</span><span class="symbol">.</span><span class="normal">f</span><span class="symbol">,</span><span class="normal"> </span><span class="number">150</span><span class="symbol">.</span><span class="normal">f</span><span class="symbol">);</span>
712
-
713
- <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="clutter-General.html#clutter-init">clutter_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">argc</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">argv</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">!=</span><span class="normal"> <a href="clutter-General.html#CLUTTER-INIT-SUCCESS:CAPS">CLUTTER_INIT_SUCCESS</a></span><span class="symbol">)</span>
714
- <span class="normal"> </span><span class="keyword">return</span><span class="normal"> </span><span class="number">1</span><span class="symbol">;</span>
715
-
716
- <span class="normal"> stage </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="ClutterStage.html#clutter-stage-new">clutter_stage_new</a></span><span class="normal"> </span><span class="symbol">();</span>
717
- <span class="normal"> </span><span class="function"><a href="ClutterStage.html#clutter-stage-set-title">clutter_stage_set_title</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">CLUTTER_STAGE</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stage</span><span class="symbol">),</span><span class="normal"> </span><span class="string">"Threading"</span><span class="symbol">);</span>
718
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-set-background-color">clutter_actor_set_background_color</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stage</span><span class="symbol">,</span><span class="normal"> CLUTTER_COLOR_Aluminium3</span><span class="symbol">);</span>
719
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-set-size">clutter_actor_set_size</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stage</span><span class="symbol">,</span><span class="normal"> </span><span class="number">600</span><span class="symbol">,</span><span class="normal"> </span><span class="number">300</span><span class="symbol">);</span>
720
- <span class="normal"> </span><span class="function">g_signal_connect</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stage</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"destroy"</span><span class="symbol">,</span><span class="normal"> </span><span class="function">G_CALLBACK</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="clutter-General.html#clutter-main-quit">clutter_main_quit</a></span><span class="symbol">),</span><span class="normal"> NULL</span><span class="symbol">);</span>
721
- <span class="normal"> </span>
722
- <span class="normal"> count_label </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="ClutterText.html#clutter-text-new-with-text">clutter_text_new_with_text</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Mono 12"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Counter"</span><span class="symbol">);</span>
723
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-set-position">clutter_actor_set_position</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">count_label</span><span class="symbol">,</span><span class="normal"> </span><span class="number">350</span><span class="symbol">,</span><span class="normal"> </span><span class="number">50</span><span class="symbol">);</span>
724
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-add-child">clutter_actor_add_child</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stage</span><span class="symbol">,</span><span class="normal"> count_label</span><span class="symbol">);</span>
725
-
726
- <span class="normal"> help_label </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="ClutterText.html#clutter-text-new-with-text">clutter_text_new_with_text</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Mono 12"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Press 's' to start"</span><span class="symbol">);</span>
727
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-set-position">clutter_actor_set_position</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">help_label</span><span class="symbol">,</span><span class="normal"> </span><span class="number">50</span><span class="symbol">,</span><span class="normal"> </span><span class="number">50</span><span class="symbol">);</span>
728
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-add-child">clutter_actor_add_child</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stage</span><span class="symbol">,</span><span class="normal"> help_label</span><span class="symbol">);</span>
729
-
730
- <span class="normal"> </span><span class="comment">/* a progress bar */</span>
731
- <span class="normal"> progress_rect </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-new">clutter_actor_new</a></span><span class="normal"> </span><span class="symbol">();</span>
732
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-set-background-color">clutter_actor_set_background_color</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">progress_rect</span><span class="symbol">,</span><span class="normal"> CLUTTER_COLOR_DarkChameleon</span><span class="symbol">);</span>
733
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-set-position">clutter_actor_set_position</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">progress_rect</span><span class="symbol">,</span><span class="normal"> </span><span class="number">50</span><span class="symbol">,</span><span class="normal"> </span><span class="number">225</span><span class="symbol">);</span>
734
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-set-size">clutter_actor_set_size</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">progress_rect</span><span class="symbol">,</span><span class="normal"> </span><span class="number">350</span><span class="symbol">,</span><span class="normal"> </span><span class="number">50</span><span class="symbol">);</span>
735
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-add-child">clutter_actor_add_child</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stage</span><span class="symbol">,</span><span class="normal"> progress_rect</span><span class="symbol">);</span>
736
-
737
- <span class="normal"> </span><span class="comment">/* an actor we bounce around */</span>
738
- <span class="normal"> rect </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-new">clutter_actor_new</a></span><span class="normal"> </span><span class="symbol">();</span>
739
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-set-background-color">clutter_actor_set_background_color</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">rect</span><span class="symbol">,</span><span class="normal"> CLUTTER_COLOR_LightScarletRed</span><span class="symbol">);</span>
740
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-set-position">clutter_actor_set_position</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">rect</span><span class="symbol">,</span><span class="normal"> </span><span class="number">75</span><span class="symbol">,</span><span class="normal"> </span><span class="number">150</span><span class="symbol">);</span>
741
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-set-size">clutter_actor_set_size</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">rect</span><span class="symbol">,</span><span class="normal"> </span><span class="number">50</span><span class="symbol">,</span><span class="normal"> </span><span class="number">50</span><span class="symbol">);</span>
742
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-set-pivot-point">clutter_actor_set_pivot_point</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">rect</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">.</span><span class="normal">5f</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">.</span><span class="normal">5f</span><span class="symbol">);</span>
743
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-set-opacity">clutter_actor_set_opacity</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">rect</span><span class="symbol">,</span><span class="normal"> </span><span class="number">224</span><span class="symbol">);</span>
744
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-add-child">clutter_actor_add_child</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stage</span><span class="symbol">,</span><span class="normal"> rect</span><span class="symbol">);</span>
745
-
746
- <span class="normal"> </span><span class="comment">/* two transitions we use to bounce rect around */</span>
747
- <span class="normal"> transition </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="ClutterPropertyTransition.html#clutter-property-transition-new">clutter_property_transition_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"rotation-angle-z"</span><span class="symbol">);</span>
748
- <span class="normal"> </span><span class="function"><a href="ClutterTransition.html#clutter-transition-set-from">clutter_transition_set_from</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">transition</span><span class="symbol">,</span><span class="normal"> G_TYPE_DOUBLE</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0.0</span><span class="symbol">);</span>
749
- <span class="normal"> </span><span class="function"><a href="ClutterTransition.html#clutter-transition-set-to">clutter_transition_set_to</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">transition</span><span class="symbol">,</span><span class="normal"> G_TYPE_DOUBLE</span><span class="symbol">,</span><span class="normal"> </span><span class="number">360.0</span><span class="symbol">);</span>
750
- <span class="normal"> </span><span class="function"><a href="ClutterTimeline.html#clutter-timeline-set-repeat-count">clutter_timeline_set_repeat_count</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">CLUTTER_TIMELINE</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">transition</span><span class="symbol">),</span><span class="normal"> </span><span class="symbol">-</span><span class="number">1</span><span class="symbol">);</span>
751
- <span class="normal"> </span><span class="function"><a href="ClutterTimeline.html#clutter-timeline-set-auto-reverse">clutter_timeline_set_auto_reverse</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">CLUTTER_TIMELINE</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">transition</span><span class="symbol">),</span><span class="normal"> TRUE</span><span class="symbol">);</span>
752
- <span class="normal"> </span><span class="function"><a href="ClutterTimeline.html#clutter-timeline-set-duration">clutter_timeline_set_duration</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">CLUTTER_TIMELINE</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">transition</span><span class="symbol">),</span><span class="normal"> </span><span class="number">3000</span><span class="symbol">);</span>
753
- <span class="normal"> flip </span><span class="symbol">=</span><span class="normal"> transition</span><span class="symbol">;</span>
754
-
755
- <span class="normal"> transition </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="ClutterPropertyTransition.html#clutter-property-transition-new">clutter_property_transition_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"position"</span><span class="symbol">);</span>
756
- <span class="normal"> </span><span class="function"><a href="ClutterTransition.html#clutter-transition-set-from">clutter_transition_set_from</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">transition</span><span class="symbol">,</span><span class="normal"> CLUTTER_TYPE_POINT</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">start</span><span class="symbol">);</span>
757
- <span class="normal"> </span><span class="function"><a href="ClutterTransition.html#clutter-transition-set-to">clutter_transition_set_to</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">transition</span><span class="symbol">,</span><span class="normal"> CLUTTER_TYPE_POINT</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">end</span><span class="symbol">);</span>
758
- <span class="normal"> </span><span class="function"><a href="ClutterTimeline.html#clutter-timeline-set-repeat-count">clutter_timeline_set_repeat_count</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">CLUTTER_TIMELINE</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">transition</span><span class="symbol">),</span><span class="normal"> </span><span class="symbol">-</span><span class="number">1</span><span class="symbol">);</span>
759
- <span class="normal"> </span><span class="function"><a href="ClutterTimeline.html#clutter-timeline-set-auto-reverse">clutter_timeline_set_auto_reverse</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">CLUTTER_TIMELINE</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">transition</span><span class="symbol">),</span><span class="normal"> TRUE</span><span class="symbol">);</span>
760
- <span class="normal"> </span><span class="function"><a href="ClutterTimeline.html#clutter-timeline-set-duration">clutter_timeline_set_duration</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">CLUTTER_TIMELINE</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">transition</span><span class="symbol">),</span><span class="normal"> </span><span class="number">3000</span><span class="symbol">);</span>
761
- <span class="normal"> bounce </span><span class="symbol">=</span><span class="normal"> transition</span><span class="symbol">;</span>
762
-
763
- <span class="normal"> </span><span class="function">g_signal_connect</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stage</span><span class="symbol">,</span>
764
- <span class="normal"> </span><span class="string">"button-press-event"</span><span class="symbol">,</span><span class="normal"> </span><span class="function">G_CALLBACK</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="clutter-General.html#clutter-main-quit">clutter_main_quit</a></span><span class="symbol">),</span>
765
- <span class="normal"> NULL</span><span class="symbol">);</span>
766
- <span class="normal"> </span><span class="function">g_signal_connect</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stage</span><span class="symbol">,</span>
767
- <span class="normal"> </span><span class="string">"key-press-event"</span><span class="symbol">,</span><span class="normal"> </span><span class="function">G_CALLBACK</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">on_key_press_event</span><span class="symbol">),</span>
768
- <span class="normal"> NULL</span><span class="symbol">);</span>
769
-
770
- <span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-show">clutter_actor_show</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stage</span><span class="symbol">);</span>
771
-
772
- <span class="normal"> </span><span class="function"><a href="clutter-General.html#clutter-main">clutter_main</a></span><span class="normal"> </span><span class="symbol">();</span>
773
-
774
- <span class="normal"> </span><span class="keyword">return</span><span class="normal"> EXIT_SUCCESS</span><span class="symbol">;</span>
775
- <span class="cbracket">}</span></pre></td>
776
- </tr>
777
- </tbody>
778
- </table>
779
- </div>
780
-
781
- </div>
782
- <br class="example-break">
783
- </div>
784
- <p>
785
- </p>
786
- </div>
787
34
  <div class="refsect1">
788
- <a name="clutter-General.details"></a><h2>Details</h2>
789
- <div class="refsect2">
790
- <a name="CLUTTER-PRIORITY-REDRAW:CAPS"></a><h3>CLUTTER_PRIORITY_REDRAW</h3>
791
- <pre class="programlisting">#define CLUTTER_PRIORITY_REDRAW (G_PRIORITY_HIGH_IDLE + 50)
792
- </pre>
793
- <p>
794
- Priority of the redraws. This is chosen to be lower than the GTK+
795
- redraw and resize priorities, because in application with both
796
- GTK+ and Clutter it's more likely that the Clutter part will be
797
- continually animating (and thus able to starve GTK+) than
798
- vice-versa.
799
- </p>
800
- <p class="since">Since 0.8</p>
801
- </div>
802
- <hr>
803
- <div class="refsect2">
804
- <a name="ClutterInitError"></a><h3>enum ClutterInitError</h3>
805
- <pre class="programlisting">typedef enum {
806
- CLUTTER_INIT_SUCCESS = 1,
807
- CLUTTER_INIT_ERROR_UNKNOWN = 0,
808
- CLUTTER_INIT_ERROR_THREADS = -1,
809
- CLUTTER_INIT_ERROR_BACKEND = -2,
810
- CLUTTER_INIT_ERROR_INTERNAL = -3
811
- } ClutterInitError;
812
- </pre>
813
- <p>
814
- Error conditions returned by <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a> and <a class="link" href="clutter-General.html#clutter-init-with-args" title="clutter_init_with_args ()"><code class="function">clutter_init_with_args()</code></a>.
815
- </p>
816
- <div class="variablelist"><table border="0" class="variablelist">
35
+ <a name="clutter-General.functions"></a><h2>Functions</h2>
36
+ <div class="informaltable"><table width="100%" border="0">
817
37
  <colgroup>
818
- <col align="left" valign="top">
819
- <col>
38
+ <col width="150px" class="functions_return">
39
+ <col class="functions_name">
820
40
  </colgroup>
821
41
  <tbody>
822
42
  <tr>
823
- <td><p><a name="CLUTTER-INIT-SUCCESS:CAPS"></a><span class="term"><code class="literal">CLUTTER_INIT_SUCCESS</code></span></p></td>
824
- <td>Initialisation successful
43
+ <td class="define_keyword">#define</td>
44
+ <td class="function_name"><a class="link" href="clutter-General.html#CLUTTER-PRIORITY-REDRAW:CAPS" title="CLUTTER_PRIORITY_REDRAW">CLUTTER_PRIORITY_REDRAW</a></td>
45
+ </tr>
46
+ <tr>
47
+ <td class="function_type">
48
+ <a class="link" href="clutter-General.html#ClutterInitError" title="enum ClutterInitError"><span class="returnvalue">ClutterInitError</span></a>
49
+ </td>
50
+ <td class="function_name">
51
+ <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()">clutter_init</a> <span class="c_punctuation">()</span>
52
+ </td>
53
+ </tr>
54
+ <tr>
55
+ <td class="function_type">
56
+ <a class="link" href="clutter-General.html#ClutterInitError" title="enum ClutterInitError"><span class="returnvalue">ClutterInitError</span></a>
57
+ </td>
58
+ <td class="function_name">
59
+ <a class="link" href="clutter-General.html#clutter-init-with-args" title="clutter_init_with_args ()">clutter_init_with_args</a> <span class="c_punctuation">()</span>
60
+ </td>
61
+ </tr>
62
+ <tr>
63
+ <td class="function_type">
64
+ <span class="returnvalue">GOptionGroup</span> *
65
+ </td>
66
+ <td class="function_name">
67
+ <a class="link" href="clutter-General.html#clutter-get-option-group" title="clutter_get_option_group ()">clutter_get_option_group</a> <span class="c_punctuation">()</span>
68
+ </td>
69
+ </tr>
70
+ <tr>
71
+ <td class="function_type">
72
+ <span class="returnvalue">GOptionGroup</span> *
73
+ </td>
74
+ <td class="function_name">
75
+ <a class="link" href="clutter-General.html#clutter-get-option-group-without-init" title="clutter_get_option_group_without_init ()">clutter_get_option_group_without_init</a> <span class="c_punctuation">()</span>
825
76
  </td>
826
77
  </tr>
827
78
  <tr>
828
- <td><p><a name="CLUTTER-INIT-ERROR-UNKNOWN:CAPS"></a><span class="term"><code class="literal">CLUTTER_INIT_ERROR_UNKNOWN</code></span></p></td>
829
- <td>Unknown error
79
+ <td class="function_type">
80
+ <span class="returnvalue">void</span>
81
+ </td>
82
+ <td class="function_name">
83
+ <a class="link" href="clutter-General.html#clutter-main" title="clutter_main ()">clutter_main</a> <span class="c_punctuation">()</span>
830
84
  </td>
831
85
  </tr>
832
86
  <tr>
833
- <td><p><a name="CLUTTER-INIT-ERROR-THREADS:CAPS"></a><span class="term"><code class="literal">CLUTTER_INIT_ERROR_THREADS</code></span></p></td>
834
- <td>Thread initialisation failed
87
+ <td class="function_type">
88
+ <span class="returnvalue">void</span>
89
+ </td>
90
+ <td class="function_name">
91
+ <a class="link" href="clutter-General.html#clutter-main-quit" title="clutter_main_quit ()">clutter_main_quit</a> <span class="c_punctuation">()</span>
835
92
  </td>
836
93
  </tr>
837
94
  <tr>
838
- <td><p><a name="CLUTTER-INIT-ERROR-BACKEND:CAPS"></a><span class="term"><code class="literal">CLUTTER_INIT_ERROR_BACKEND</code></span></p></td>
839
- <td>Backend initialisation failed
95
+ <td class="function_type">
96
+ <span class="returnvalue">gint</span>
97
+ </td>
98
+ <td class="function_name">
99
+ <a class="link" href="clutter-General.html#clutter-main-level" title="clutter_main_level ()">clutter_main_level</a> <span class="c_punctuation">()</span>
840
100
  </td>
841
101
  </tr>
842
102
  <tr>
843
- <td><p><a name="CLUTTER-INIT-ERROR-INTERNAL:CAPS"></a><span class="term"><code class="literal">CLUTTER_INIT_ERROR_INTERNAL</code></span></p></td>
844
- <td>Internal error
103
+ <td class="function_type">
104
+ <span class="returnvalue">gboolean</span>
105
+ </td>
106
+ <td class="function_name">
107
+ <a class="link" href="clutter-General.html#clutter-get-debug-enabled" title="clutter_get_debug_enabled ()">clutter_get_debug_enabled</a> <span class="c_punctuation">()</span>
108
+ </td>
109
+ </tr>
110
+ <tr>
111
+ <td class="function_type">
112
+ <span class="returnvalue">gboolean</span>
113
+ </td>
114
+ <td class="function_name">
115
+ <a class="link" href="clutter-General.html#clutter-get-show-fps" title="clutter_get_show_fps ()">clutter_get_show_fps</a> <span class="c_punctuation">()</span>
116
+ </td>
117
+ </tr>
118
+ <tr>
119
+ <td class="function_type">
120
+ <span class="returnvalue">gulong</span>
121
+ </td>
122
+ <td class="function_name">
123
+ <a class="link" href="clutter-General.html#clutter-get-timestamp" title="clutter_get_timestamp ()">clutter_get_timestamp</a> <span class="c_punctuation">()</span>
124
+ </td>
125
+ </tr>
126
+ <tr>
127
+ <td class="function_type">
128
+ <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="returnvalue">ClutterActor</span></a> *
129
+ </td>
130
+ <td class="function_name">
131
+ <a class="link" href="clutter-General.html#clutter-get-actor-by-gid" title="clutter_get_actor_by_gid ()">clutter_get_actor_by_gid</a> <span class="c_punctuation">()</span>
132
+ </td>
133
+ </tr>
134
+ <tr>
135
+ <td class="function_type">
136
+ <span class="returnvalue">void</span>
137
+ </td>
138
+ <td class="function_name">
139
+ <a class="link" href="clutter-General.html#clutter-set-default-frame-rate" title="clutter_set_default_frame_rate ()">clutter_set_default_frame_rate</a> <span class="c_punctuation">()</span>
140
+ </td>
141
+ </tr>
142
+ <tr>
143
+ <td class="function_type">
144
+ <span class="returnvalue">guint</span>
145
+ </td>
146
+ <td class="function_name">
147
+ <a class="link" href="clutter-General.html#clutter-get-default-frame-rate" title="clutter_get_default_frame_rate ()">clutter_get_default_frame_rate</a> <span class="c_punctuation">()</span>
148
+ </td>
149
+ </tr>
150
+ <tr>
151
+ <td class="function_type">
152
+ <span class="returnvalue">void</span>
153
+ </td>
154
+ <td class="function_name">
155
+ <a class="link" href="clutter-General.html#clutter-set-motion-events-enabled" title="clutter_set_motion_events_enabled ()">clutter_set_motion_events_enabled</a> <span class="c_punctuation">()</span>
156
+ </td>
157
+ </tr>
158
+ <tr>
159
+ <td class="function_type">
160
+ <span class="returnvalue">gboolean</span>
161
+ </td>
162
+ <td class="function_name">
163
+ <a class="link" href="clutter-General.html#clutter-get-motion-events-enabled" title="clutter_get_motion_events_enabled ()">clutter_get_motion_events_enabled</a> <span class="c_punctuation">()</span>
164
+ </td>
165
+ </tr>
166
+ <tr>
167
+ <td class="function_type">
168
+ <span class="returnvalue">void</span>
169
+ </td>
170
+ <td class="function_name">
171
+ <a class="link" href="clutter-General.html#clutter-clear-glyph-cache" title="clutter_clear_glyph_cache ()">clutter_clear_glyph_cache</a> <span class="c_punctuation">()</span>
172
+ </td>
173
+ </tr>
174
+ <tr>
175
+ <td class="function_type">
176
+ <span class="returnvalue">void</span>
177
+ </td>
178
+ <td class="function_name">
179
+ <a class="link" href="clutter-General.html#clutter-set-font-flags" title="clutter_set_font_flags ()">clutter_set_font_flags</a> <span class="c_punctuation">()</span>
180
+ </td>
181
+ </tr>
182
+ <tr>
183
+ <td class="function_type">
184
+ <a class="link" href="clutter-General.html#ClutterFontFlags" title="enum ClutterFontFlags"><span class="returnvalue">ClutterFontFlags</span></a>
185
+ </td>
186
+ <td class="function_name">
187
+ <a class="link" href="clutter-General.html#clutter-get-font-flags" title="clutter_get_font_flags ()">clutter_get_font_flags</a> <span class="c_punctuation">()</span>
188
+ </td>
189
+ </tr>
190
+ <tr>
191
+ <td class="function_type">
192
+ <span class="returnvalue">PangoFontMap</span> *
193
+ </td>
194
+ <td class="function_name">
195
+ <a class="link" href="clutter-General.html#clutter-get-font-map" title="clutter_get_font_map ()">clutter_get_font_map</a> <span class="c_punctuation">()</span>
196
+ </td>
197
+ </tr>
198
+ <tr>
199
+ <td class="function_type">
200
+ <a class="link" href="clutter-General.html#ClutterTextDirection" title="enum ClutterTextDirection"><span class="returnvalue">ClutterTextDirection</span></a>
201
+ </td>
202
+ <td class="function_name">
203
+ <a class="link" href="clutter-General.html#clutter-get-default-text-direction" title="clutter_get_default_text_direction ()">clutter_get_default_text_direction</a> <span class="c_punctuation">()</span>
204
+ </td>
205
+ </tr>
206
+ <tr>
207
+ <td class="function_type">
208
+ <span class="returnvalue">gboolean</span>
209
+ </td>
210
+ <td class="function_name">
211
+ <a class="link" href="clutter-General.html#clutter-get-accessibility-enabled" title="clutter_get_accessibility_enabled ()">clutter_get_accessibility_enabled</a> <span class="c_punctuation">()</span>
212
+ </td>
213
+ </tr>
214
+ <tr>
215
+ <td class="function_type">
216
+ <span class="returnvalue">void</span>
217
+ </td>
218
+ <td class="function_name">
219
+ <a class="link" href="clutter-General.html#clutter-disable-accessibility" title="clutter_disable_accessibility ()">clutter_disable_accessibility</a> <span class="c_punctuation">()</span>
220
+ </td>
221
+ </tr>
222
+ <tr>
223
+ <td class="function_type">
224
+ <span class="returnvalue">void</span>
225
+ </td>
226
+ <td class="function_name">
227
+ <a class="link" href="clutter-General.html#clutter-threads-set-lock-functions" title="clutter_threads_set_lock_functions ()">clutter_threads_set_lock_functions</a> <span class="c_punctuation">()</span>
228
+ </td>
229
+ </tr>
230
+ <tr>
231
+ <td class="function_type">
232
+ <span class="returnvalue">void</span>
233
+ </td>
234
+ <td class="function_name">
235
+ <a class="link" href="clutter-General.html#clutter-threads-init" title="clutter_threads_init ()">clutter_threads_init</a> <span class="c_punctuation">()</span>
236
+ </td>
237
+ </tr>
238
+ <tr>
239
+ <td class="function_type">
240
+ <span class="returnvalue">void</span>
241
+ </td>
242
+ <td class="function_name">
243
+ <a class="link" href="clutter-General.html#clutter-threads-enter" title="clutter_threads_enter ()">clutter_threads_enter</a> <span class="c_punctuation">()</span>
244
+ </td>
245
+ </tr>
246
+ <tr>
247
+ <td class="function_type">
248
+ <span class="returnvalue">void</span>
249
+ </td>
250
+ <td class="function_name">
251
+ <a class="link" href="clutter-General.html#clutter-threads-leave" title="clutter_threads_leave ()">clutter_threads_leave</a> <span class="c_punctuation">()</span>
252
+ </td>
253
+ </tr>
254
+ <tr>
255
+ <td class="function_type">
256
+ <span class="returnvalue">guint</span>
257
+ </td>
258
+ <td class="function_name">
259
+ <a class="link" href="clutter-General.html#clutter-threads-add-idle" title="clutter_threads_add_idle ()">clutter_threads_add_idle</a> <span class="c_punctuation">()</span>
260
+ </td>
261
+ </tr>
262
+ <tr>
263
+ <td class="function_type">
264
+ <span class="returnvalue">guint</span>
265
+ </td>
266
+ <td class="function_name">
267
+ <a class="link" href="clutter-General.html#clutter-threads-add-idle-full" title="clutter_threads_add_idle_full ()">clutter_threads_add_idle_full</a> <span class="c_punctuation">()</span>
268
+ </td>
269
+ </tr>
270
+ <tr>
271
+ <td class="function_type">
272
+ <span class="returnvalue">guint</span>
273
+ </td>
274
+ <td class="function_name">
275
+ <a class="link" href="clutter-General.html#clutter-threads-add-timeout" title="clutter_threads_add_timeout ()">clutter_threads_add_timeout</a> <span class="c_punctuation">()</span>
276
+ </td>
277
+ </tr>
278
+ <tr>
279
+ <td class="function_type">
280
+ <span class="returnvalue">guint</span>
281
+ </td>
282
+ <td class="function_name">
283
+ <a class="link" href="clutter-General.html#clutter-threads-add-timeout-full" title="clutter_threads_add_timeout_full ()">clutter_threads_add_timeout_full</a> <span class="c_punctuation">()</span>
284
+ </td>
285
+ </tr>
286
+ <tr>
287
+ <td class="function_type">
288
+ <span class="returnvalue">guint</span>
289
+ </td>
290
+ <td class="function_name">
291
+ <a class="link" href="clutter-General.html#clutter-threads-add-frame-source" title="clutter_threads_add_frame_source ()">clutter_threads_add_frame_source</a> <span class="c_punctuation">()</span>
292
+ </td>
293
+ </tr>
294
+ <tr>
295
+ <td class="function_type">
296
+ <span class="returnvalue">guint</span>
297
+ </td>
298
+ <td class="function_name">
299
+ <a class="link" href="clutter-General.html#clutter-threads-add-frame-source-full" title="clutter_threads_add_frame_source_full ()">clutter_threads_add_frame_source_full</a> <span class="c_punctuation">()</span>
300
+ </td>
301
+ </tr>
302
+ <tr>
303
+ <td class="function_type">
304
+ <span class="returnvalue">guint</span>
305
+ </td>
306
+ <td class="function_name">
307
+ <a class="link" href="clutter-General.html#clutter-threads-add-repaint-func" title="clutter_threads_add_repaint_func ()">clutter_threads_add_repaint_func</a> <span class="c_punctuation">()</span>
308
+ </td>
309
+ </tr>
310
+ <tr>
311
+ <td class="function_type">
312
+ <span class="returnvalue">guint</span>
313
+ </td>
314
+ <td class="function_name">
315
+ <a class="link" href="clutter-General.html#clutter-threads-add-repaint-func-full" title="clutter_threads_add_repaint_func_full ()">clutter_threads_add_repaint_func_full</a> <span class="c_punctuation">()</span>
316
+ </td>
317
+ </tr>
318
+ <tr>
319
+ <td class="function_type">
320
+ <span class="returnvalue">void</span>
321
+ </td>
322
+ <td class="function_name">
323
+ <a class="link" href="clutter-General.html#clutter-threads-remove-repaint-func" title="clutter_threads_remove_repaint_func ()">clutter_threads_remove_repaint_func</a> <span class="c_punctuation">()</span>
324
+ </td>
325
+ </tr>
326
+ <tr>
327
+ <td class="function_type">
328
+ <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="returnvalue">ClutterActor</span></a> *
329
+ </td>
330
+ <td class="function_name">
331
+ <a class="link" href="clutter-General.html#clutter-get-keyboard-grab" title="clutter_get_keyboard_grab ()">clutter_get_keyboard_grab</a> <span class="c_punctuation">()</span>
332
+ </td>
333
+ </tr>
334
+ <tr>
335
+ <td class="function_type">
336
+ <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="returnvalue">ClutterActor</span></a> *
337
+ </td>
338
+ <td class="function_name">
339
+ <a class="link" href="clutter-General.html#clutter-get-pointer-grab" title="clutter_get_pointer_grab ()">clutter_get_pointer_grab</a> <span class="c_punctuation">()</span>
340
+ </td>
341
+ </tr>
342
+ <tr>
343
+ <td class="function_type">
344
+ <span class="returnvalue">void</span>
345
+ </td>
346
+ <td class="function_name">
347
+ <a class="link" href="clutter-General.html#clutter-grab-keyboard" title="clutter_grab_keyboard ()">clutter_grab_keyboard</a> <span class="c_punctuation">()</span>
348
+ </td>
349
+ </tr>
350
+ <tr>
351
+ <td class="function_type">
352
+ <span class="returnvalue">void</span>
353
+ </td>
354
+ <td class="function_name">
355
+ <a class="link" href="clutter-General.html#clutter-grab-pointer" title="clutter_grab_pointer ()">clutter_grab_pointer</a> <span class="c_punctuation">()</span>
356
+ </td>
357
+ </tr>
358
+ <tr>
359
+ <td class="function_type">
360
+ <span class="returnvalue">void</span>
361
+ </td>
362
+ <td class="function_name">
363
+ <a class="link" href="clutter-General.html#clutter-ungrab-keyboard" title="clutter_ungrab_keyboard ()">clutter_ungrab_keyboard</a> <span class="c_punctuation">()</span>
364
+ </td>
365
+ </tr>
366
+ <tr>
367
+ <td class="function_type">
368
+ <span class="returnvalue">void</span>
369
+ </td>
370
+ <td class="function_name">
371
+ <a class="link" href="clutter-General.html#clutter-ungrab-pointer" title="clutter_ungrab_pointer ()">clutter_ungrab_pointer</a> <span class="c_punctuation">()</span>
372
+ </td>
373
+ </tr>
374
+ <tr>
375
+ <td class="function_type">
376
+ <span class="returnvalue">void</span>
377
+ </td>
378
+ <td class="function_name">
379
+ <a class="link" href="clutter-General.html#clutter-grab-pointer-for-device" title="clutter_grab_pointer_for_device ()">clutter_grab_pointer_for_device</a> <span class="c_punctuation">()</span>
380
+ </td>
381
+ </tr>
382
+ <tr>
383
+ <td class="function_type">
384
+ <span class="returnvalue">void</span>
385
+ </td>
386
+ <td class="function_name">
387
+ <a class="link" href="clutter-General.html#clutter-ungrab-pointer-for-device" title="clutter_ungrab_pointer_for_device ()">clutter_ungrab_pointer_for_device</a> <span class="c_punctuation">()</span>
388
+ </td>
389
+ </tr>
390
+ <tr>
391
+ <td class="function_type">
392
+ <span class="returnvalue">void</span>
393
+ </td>
394
+ <td class="function_name">
395
+ <a class="link" href="clutter-General.html#clutter-do-event" title="clutter_do_event ()">clutter_do_event</a> <span class="c_punctuation">()</span>
845
396
  </td>
846
397
  </tr>
847
398
  </tbody>
848
399
  </table></div>
849
- <p class="since">Since 0.2</p>
400
+ </div>
401
+ <div class="refsect1">
402
+ <a name="clutter-General.other"></a><h2>Types and Values</h2>
403
+ <div class="informaltable"><table width="100%" border="0">
404
+ <colgroup>
405
+ <col width="150px" class="name">
406
+ <col class="description">
407
+ </colgroup>
408
+ <tbody>
409
+ <tr>
410
+ <td class="datatype_keyword">enum</td>
411
+ <td class="function_name"><a class="link" href="clutter-General.html#ClutterInitError" title="enum ClutterInitError">ClutterInitError</a></td>
412
+ </tr>
413
+ <tr>
414
+ <td class="datatype_keyword">enum</td>
415
+ <td class="function_name"><a class="link" href="clutter-General.html#ClutterFontFlags" title="enum ClutterFontFlags">ClutterFontFlags</a></td>
416
+ </tr>
417
+ <tr>
418
+ <td class="datatype_keyword">enum</td>
419
+ <td class="function_name"><a class="link" href="clutter-General.html#ClutterTextDirection" title="enum ClutterTextDirection">ClutterTextDirection</a></td>
420
+ </tr>
421
+ <tr>
422
+ <td class="datatype_keyword">enum</td>
423
+ <td class="function_name"><a class="link" href="clutter-General.html#ClutterRepaintFlags" title="enum ClutterRepaintFlags">ClutterRepaintFlags</a></td>
424
+ </tr>
425
+ </tbody>
426
+ </table></div>
427
+ </div>
428
+ <div class="refsect1">
429
+ <a name="clutter-General.description"></a><h2>Description</h2>
430
+ <p>Functions to retrieve various global Clutter resources and other utility
431
+ functions for mainloops, events and threads</p>
432
+ <div class="refsect3">
433
+ <a name="id-1.7.2.9.5.3"></a><h4>The Clutter Threading Model</h4>
434
+ <p>Clutter is *thread-aware*: all operations performed by Clutter are assumed
435
+ to be under the Big Clutter Lock, which is created when the threading is
436
+ initialized through <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a>, and entered when calling user-related
437
+ code during event handling and actor drawing.</p>
438
+ <p>The only safe and portable way to use the Clutter API in a multi-threaded
439
+ environment is to only access the Clutter API from a thread that did called
440
+ <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a> and <a class="link" href="clutter-General.html#clutter-main" title="clutter_main ()"><code class="function">clutter_main()</code></a>.</p>
441
+ <p>The common pattern for using threads with Clutter is to use worker threads
442
+ to perform blocking operations and then install idle or timeout sources with
443
+ the result when the thread finishes, and update the UI from those callbacks.</p>
444
+ <p>For a working example of how to use a worker thread to update the UI, see
445
+ <a class="ulink" href="https://git.gnome.org/browse/clutter/tree/examples/threads.c?h=clutter-1.18" target="_top">threads.c</a></p>
446
+ </div>
447
+ </div>
448
+ <div class="refsect1">
449
+ <a name="clutter-General.functions_details"></a><h2>Functions</h2>
450
+ <div class="refsect2">
451
+ <a name="CLUTTER-PRIORITY-REDRAW:CAPS"></a><h3>CLUTTER_PRIORITY_REDRAW</h3>
452
+ <pre class="programlisting">#define CLUTTER_PRIORITY_REDRAW (G_PRIORITY_HIGH_IDLE + 50)
453
+ </pre>
454
+ <p>Priority of the redraws. This is chosen to be lower than the GTK+
455
+ redraw and resize priorities, because in application with both
456
+ GTK+ and Clutter it's more likely that the Clutter part will be
457
+ continually animating (and thus able to starve GTK+) than
458
+ vice-versa.</p>
459
+ <p class="since">Since 0.8</p>
850
460
  </div>
851
461
  <hr>
852
462
  <div class="refsect2">
853
- <a name="clutter-init"></a><h3>clutter_init ()</h3>
854
- <pre class="programlisting"><a class="link" href="clutter-General.html#ClutterInitError" title="enum ClutterInitError"><span class="returnvalue">ClutterInitError</span></a> clutter_init (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
855
- <em class="parameter"><code><span class="type">char</span> ***argv</code></em>);</pre>
856
- <p>
857
- Initialises everything needed to operate with Clutter and parses some
858
- standard command line options; <em class="parameter"><code>argc</code></em> and <em class="parameter"><code>argv</code></em> are adjusted accordingly
859
- so your own code will never see those standard arguments.
860
- </p>
861
- <p>
862
- It is safe to call this function multiple times.
863
- </p>
864
- <p>
865
- </p>
866
- <div class="note">
867
- <h3 class="title">Note</h3>This function will not abort in case of errors during
868
- initialization; <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a> will print out the error message on
463
+ <a name="clutter-init"></a><h3>clutter_init ()</h3>
464
+ <pre class="programlisting"><a class="link" href="clutter-General.html#ClutterInitError" title="enum ClutterInitError"><span class="returnvalue">ClutterInitError</span></a>
465
+ clutter_init (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
466
+ <em class="parameter"><code><span class="type">char</span> ***argv</code></em>);</pre>
467
+ <p>Initialises everything needed to operate with Clutter and parses some
468
+ standard command line options; <em class="parameter"><code>argc</code></em>
469
+ and <em class="parameter"><code>argv</code></em>
470
+ are adjusted accordingly
471
+ so your own code will never see those standard arguments.</p>
472
+ <p>It is safe to call this function multiple times.</p>
473
+ <p>This function will not abort in case of errors during
474
+ initialization; <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a> will print out the error message on
869
475
  stderr, and will return an error code. It is up to the application
870
476
  code to handle this case. If you need to display the error message
871
- yourself, you can use <a class="link" href="clutter-General.html#clutter-init-with-args" title="clutter_init_with_args ()"><code class="function">clutter_init_with_args()</code></a>, which takes a <span class="type">GError</span>
872
- pointer.</div>
873
- <p>
874
- </p>
875
- <p>
876
- If this function fails, and returns an error code, any subsequent
477
+ yourself, you can use <a class="link" href="clutter-General.html#clutter-init-with-args" title="clutter_init_with_args ()"><code class="function">clutter_init_with_args()</code></a>, which takes a <span class="type">GError</span>
478
+ pointer.</p>
479
+ <p>If this function fails, and returns an error code, any subsequent
877
480
  Clutter API will have undefined behaviour - including segmentation
878
481
  faults and assertion failures. Make sure to handle the returned
879
- <a class="link" href="clutter-General.html#ClutterInitError" title="enum ClutterInitError"><span class="type">ClutterInitError</span></a> enumeration value.
880
- </p>
881
- <div class="variablelist"><table border="0" class="variablelist">
482
+ <a class="link" href="clutter-General.html#ClutterInitError" title="enum ClutterInitError"><span class="type">ClutterInitError</span></a> enumeration value.</p>
483
+ <div class="refsect3">
484
+ <a name="id-1.7.2.9.6.3.8"></a><h4>Parameters</h4>
485
+ <div class="informaltable"><table width="100%" border="0">
882
486
  <colgroup>
883
- <col align="left" valign="top">
884
- <col>
487
+ <col width="150px" class="parameters_name">
488
+ <col class="parameters_description">
489
+ <col width="200px" class="parameters_annotations">
885
490
  </colgroup>
886
491
  <tbody>
887
492
  <tr>
888
- <td><p><span class="term"><em class="parameter"><code>argc</code></em> :</span></p></td>
889
- <td>The number of arguments in <em class="parameter"><code>argv</code></em>. <span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>]</span>
890
- </td>
493
+ <td class="parameter_name"><p>argc</p></td>
494
+ <td class="parameter_description"><p> The number of arguments in <em class="parameter"><code>argv</code></em>
495
+ . </p></td>
496
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>]</span></td>
891
497
  </tr>
892
498
  <tr>
893
- <td><p><span class="term"><em class="parameter"><code>argv</code></em> :</span></p></td>
894
- <td>A pointer to an array
895
- of arguments. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=argc][<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
896
- </td>
897
- </tr>
898
- <tr>
899
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
900
- <td>a <a class="link" href="clutter-General.html#ClutterInitError" title="enum ClutterInitError"><span class="type">ClutterInitError</span></a> value</td>
499
+ <td class="parameter_name"><p>argv</p></td>
500
+ <td class="parameter_description"><p> A pointer to an array
501
+ of arguments. </p></td>
502
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=argc][<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
901
503
  </tr>
902
504
  </tbody>
903
505
  </table></div>
904
506
  </div>
507
+ <div class="refsect3">
508
+ <a name="id-1.7.2.9.6.3.9"></a><h4>Returns</h4>
509
+ <p> a <a class="link" href="clutter-General.html#ClutterInitError" title="enum ClutterInitError"><span class="type">ClutterInitError</span></a> value</p>
510
+ <p></p>
511
+ </div>
512
+ </div>
905
513
  <hr>
906
514
  <div class="refsect2">
907
- <a name="clutter-init-with-args"></a><h3>clutter_init_with_args ()</h3>
908
- <pre class="programlisting"><a class="link" href="clutter-General.html#ClutterInitError" title="enum ClutterInitError"><span class="returnvalue">ClutterInitError</span></a> clutter_init_with_args (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
909
- <em class="parameter"><code><span class="type">char</span> ***argv</code></em>,
910
- <em class="parameter"><code>const <span class="type">char</span> *parameter_string</code></em>,
911
- <em class="parameter"><code><span class="type">GOptionEntry</span> *entries</code></em>,
912
- <em class="parameter"><code>const <span class="type">char</span> *translation_domain</code></em>,
913
- <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
914
- <p>
915
- This function does the same work as <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a>. Additionally,
515
+ <a name="clutter-init-with-args"></a><h3>clutter_init_with_args ()</h3>
516
+ <pre class="programlisting"><a class="link" href="clutter-General.html#ClutterInitError" title="enum ClutterInitError"><span class="returnvalue">ClutterInitError</span></a>
517
+ clutter_init_with_args (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
518
+ <em class="parameter"><code><span class="type">char</span> ***argv</code></em>,
519
+ <em class="parameter"><code>const <span class="type">char</span> *parameter_string</code></em>,
520
+ <em class="parameter"><code><span class="type">GOptionEntry</span> *entries</code></em>,
521
+ <em class="parameter"><code>const <span class="type">char</span> *translation_domain</code></em>,
522
+ <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
523
+ <p>This function does the same work as <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a>. Additionally,
916
524
  it allows you to add your own command line options, and it
917
- automatically generates nicely formatted <code class="option">--help</code>
525
+ automatically generates nicely formatted &lt;option&gt;--help&lt;/option&gt;
918
526
  output. Note that your program will be terminated after writing
919
527
  out the help output. Also note that, in case of error, the
920
- error message will be placed inside <em class="parameter"><code>error</code></em> instead of being
921
- printed on the display.
922
- </p>
923
- <p>
924
- Just like <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a>, if this function returns an error code then
528
+ error message will be placed inside <em class="parameter"><code>error</code></em>
529
+ instead of being
530
+ printed on the display.</p>
531
+ <p>Just like <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a>, if this function returns an error code then
925
532
  any subsequent call to any other Clutter API will result in undefined
926
- behaviour - including segmentation faults.
927
- </p>
928
- <div class="variablelist"><table border="0" class="variablelist">
533
+ behaviour - including segmentation faults.</p>
534
+ <div class="refsect3">
535
+ <a name="id-1.7.2.9.6.4.6"></a><h4>Parameters</h4>
536
+ <div class="informaltable"><table width="100%" border="0">
929
537
  <colgroup>
930
- <col align="left" valign="top">
931
- <col>
538
+ <col width="150px" class="parameters_name">
539
+ <col class="parameters_description">
540
+ <col width="200px" class="parameters_annotations">
932
541
  </colgroup>
933
542
  <tbody>
934
543
  <tr>
935
- <td><p><span class="term"><em class="parameter"><code>argc</code></em> :</span></p></td>
936
- <td>a pointer to the number of command line arguments. <span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>]</span>
937
- </td>
938
- </tr>
939
- <tr>
940
- <td><p><span class="term"><em class="parameter"><code>argv</code></em> :</span></p></td>
941
- <td>a pointer to the array
942
- of command line arguments. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=argc][<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
943
- </td>
544
+ <td class="parameter_name"><p>argc</p></td>
545
+ <td class="parameter_description"><p> a pointer to the number of command line arguments. </p></td>
546
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>]</span></td>
944
547
  </tr>
945
548
  <tr>
946
- <td><p><span class="term"><em class="parameter"><code>parameter_string</code></em> :</span></p></td>
947
- <td>a string which is displayed in the
948
- first line of <code class="option">--help</code> output, after
949
- <code class="literal"><em class="replaceable"><code>programname</code></em> [OPTION...]</code>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
950
- </td>
549
+ <td class="parameter_name"><p>argv</p></td>
550
+ <td class="parameter_description"><p> a pointer to the array
551
+ of command line arguments. </p></td>
552
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=argc][<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
951
553
  </tr>
952
554
  <tr>
953
- <td><p><span class="term"><em class="parameter"><code>entries</code></em> :</span></p></td>
954
- <td>a <code class="literal">NULL</code> terminated array of
955
- <span class="type">GOptionEntry</span>s describing the options of your program. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
956
- </td>
555
+ <td class="parameter_name"><p>parameter_string</p></td>
556
+ <td class="parameter_description"><p> a string which is displayed in the
557
+ first line of &lt;option&gt;--help&lt;/option&gt; output, after
558
+ &lt;literal&gt;&lt;replaceable&gt;programname&lt;/replaceable&gt; [OPTION...]&lt;/literal&gt;. </p></td>
559
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
957
560
  </tr>
958
561
  <tr>
959
- <td><p><span class="term"><em class="parameter"><code>translation_domain</code></em> :</span></p></td>
960
- <td>a translation domain to use for
961
- translating the <code class="option">--help</code> output for the options in
962
- <em class="parameter"><code>entries</code></em> with <code class="function">gettext()</code>, or <code class="literal">NULL</code>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
963
- </td>
562
+ <td class="parameter_name"><p>entries</p></td>
563
+ <td class="parameter_description"><p> a <code class="literal">NULL</code> terminated array of
564
+ <span class="type">GOptionEntry</span>&lt;!-- --&gt;s describing the options of your program. </p></td>
565
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
964
566
  </tr>
965
567
  <tr>
966
- <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
967
- <td>a return location for a <span class="type">GError</span>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
968
- </td>
568
+ <td class="parameter_name"><p>translation_domain</p></td>
569
+ <td class="parameter_description"><p> a translation domain to use for
570
+ translating the &lt;option&gt;--help&lt;/option&gt; output for the options in
571
+ <em class="parameter"><code>entries</code></em>
572
+ with <code class="function">gettext()</code>, or <code class="literal">NULL</code>. </p></td>
573
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
969
574
  </tr>
970
575
  <tr>
971
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
972
- <td>
973
- <a class="link" href="clutter-General.html#CLUTTER-INIT-SUCCESS:CAPS"><code class="literal">CLUTTER_INIT_SUCCESS</code></a> if Clutter has been successfully
974
- initialised, or other values or <a class="link" href="clutter-General.html#ClutterInitError" title="enum ClutterInitError"><span class="type">ClutterInitError</span></a> in case of
975
- error.</td>
576
+ <td class="parameter_name"><p>error</p></td>
577
+ <td class="parameter_description"><p> a return location for a <span class="type">GError</span>. </p></td>
578
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
976
579
  </tr>
977
580
  </tbody>
978
581
  </table></div>
582
+ </div>
583
+ <div class="refsect3">
584
+ <a name="id-1.7.2.9.6.4.7"></a><h4>Returns</h4>
585
+ <p> <a class="link" href="clutter-General.html#CLUTTER-INIT-SUCCESS:CAPS"><code class="literal">CLUTTER_INIT_SUCCESS</code></a> if Clutter has been successfully
586
+ initialised, or other values or <a class="link" href="clutter-General.html#ClutterInitError" title="enum ClutterInitError"><span class="type">ClutterInitError</span></a> in case of
587
+ error.</p>
588
+ <p></p>
589
+ </div>
979
590
  <p class="since">Since 0.2</p>
980
591
  </div>
981
592
  <hr>
982
593
  <div class="refsect2">
983
- <a name="clutter-get-option-group"></a><h3>clutter_get_option_group ()</h3>
984
- <pre class="programlisting"><span class="returnvalue">GOptionGroup</span> * clutter_get_option_group (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
985
- <p>
986
- Returns a <span class="type">GOptionGroup</span> for the command line arguments recognized
594
+ <a name="clutter-get-option-group"></a><h3>clutter_get_option_group ()</h3>
595
+ <pre class="programlisting"><span class="returnvalue">GOptionGroup</span> *
596
+ clutter_get_option_group (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
597
+ <p>Returns a <span class="type">GOptionGroup</span> for the command line arguments recognized
987
598
  by Clutter. You should add this group to your <span class="type">GOptionContext</span> with
988
599
  <code class="function">g_option_context_add_group()</code>, if you are using <code class="function">g_option_context_parse()</code>
989
- to parse your commandline arguments.
990
- </p>
991
- <p>
992
- Calling <code class="function">g_option_context_parse()</code> with Clutter's <span class="type">GOptionGroup</span> will result
993
- in Clutter's initialization. That is, the following code:
994
- </p>
995
- <p>
996
- </p>
600
+ to parse your commandline arguments.</p>
601
+ <p>Calling <code class="function">g_option_context_parse()</code> with Clutter's <span class="type">GOptionGroup</span> will result
602
+ in Clutter's initialization. That is, the following code:</p>
997
603
  <div class="informalexample">
998
604
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
999
605
  <tbody>
@@ -1007,13 +613,8 @@ in Clutter's initialization. That is, the following code:
1007
613
  </table>
1008
614
  </div>
1009
615
 
1010
- <p>
1011
- </p>
1012
- <p>
1013
- is functionally equivalent to:
1014
- </p>
1015
- <p>
1016
- </p>
616
+ <p></p>
617
+ <p>is functionally equivalent to:</p>
1017
618
  <div class="informalexample">
1018
619
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1019
620
  <tbody>
@@ -1025,703 +626,535 @@ is functionally equivalent to:
1025
626
  </table>
1026
627
  </div>
1027
628
 
1028
- <p>
1029
- </p>
1030
- <p>
1031
- After <code class="function">g_option_context_parse()</code> on a <span class="type">GOptionContext</span> containing the
629
+ <p></p>
630
+ <p>After <code class="function">g_option_context_parse()</code> on a <span class="type">GOptionContext</span> containing the
1032
631
  Clutter <span class="type">GOptionGroup</span> has returned <code class="literal">TRUE</code>, Clutter is guaranteed to be
1033
- initialized.
1034
- </p>
1035
- <div class="variablelist"><table border="0" class="variablelist">
1036
- <colgroup>
1037
- <col align="left" valign="top">
1038
- <col>
1039
- </colgroup>
1040
- <tbody><tr>
1041
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1042
- <td>a <span class="type">GOptionGroup</span> for the commandline arguments
1043
- recognized by Clutter. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1044
- </td>
1045
- </tr></tbody>
1046
- </table></div>
632
+ initialized.</p>
633
+ <div class="refsect3">
634
+ <a name="id-1.7.2.9.6.5.12"></a><h4>Returns</h4>
635
+ <p> a <span class="type">GOptionGroup</span> for the commandline arguments
636
+ recognized by Clutter. </p>
637
+ <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
638
+ </div>
1047
639
  <p class="since">Since 0.2</p>
1048
640
  </div>
1049
641
  <hr>
1050
642
  <div class="refsect2">
1051
- <a name="clutter-get-option-group-without-init"></a><h3>clutter_get_option_group_without_init ()</h3>
1052
- <pre class="programlisting"><span class="returnvalue">GOptionGroup</span> * clutter_get_option_group_without_init
1053
- (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1054
- <p>
1055
- Returns a <span class="type">GOptionGroup</span> for the command line arguments recognized
643
+ <a name="clutter-get-option-group-without-init"></a><h3>clutter_get_option_group_without_init ()</h3>
644
+ <pre class="programlisting"><span class="returnvalue">GOptionGroup</span> *
645
+ clutter_get_option_group_without_init (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
646
+ <p>Returns a <span class="type">GOptionGroup</span> for the command line arguments recognized
1056
647
  by Clutter. You should add this group to your <span class="type">GOptionContext</span> with
1057
648
  <code class="function">g_option_context_add_group()</code>, if you are using <code class="function">g_option_context_parse()</code>
1058
- to parse your commandline arguments.
1059
- </p>
1060
- <p>
1061
- Unlike <a class="link" href="clutter-General.html#clutter-get-option-group" title="clutter_get_option_group ()"><code class="function">clutter_get_option_group()</code></a>, calling <code class="function">g_option_context_parse()</code> with
649
+ to parse your commandline arguments.</p>
650
+ <p>Unlike <a class="link" href="clutter-General.html#clutter-get-option-group" title="clutter_get_option_group ()"><code class="function">clutter_get_option_group()</code></a>, calling <code class="function">g_option_context_parse()</code> with
1062
651
  the <span class="type">GOptionGroup</span> returned by this function requires a subsequent explicit
1063
- call to <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a>; use this function when needing to set foreign
1064
- display connection with <a class="link" href="clutter-X11-Specific-Support.html#clutter-x11-set-display" title="clutter_x11_set_display ()"><code class="function">clutter_x11_set_display()</code></a>, or with
1065
- <code class="function"><code class="function">gtk_clutter_init()</code></code>.
1066
- </p>
1067
- <div class="variablelist"><table border="0" class="variablelist">
1068
- <colgroup>
1069
- <col align="left" valign="top">
1070
- <col>
1071
- </colgroup>
1072
- <tbody><tr>
1073
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1074
- <td>a <span class="type">GOptionGroup</span> for the commandline arguments
1075
- recognized by Clutter. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1076
- </td>
1077
- </tr></tbody>
1078
- </table></div>
652
+ call to <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a>; use this function when needing to set foreign
653
+ display connection with <a class="link" href="clutter-X11-Specific-Support.html#clutter-x11-set-display" title="clutter_x11_set_display ()"><code class="function">clutter_x11_set_display()</code></a>, or with
654
+ <code class="literal"><code class="function">gtk_clutter_init()</code></code>.</p>
655
+ <div class="refsect3">
656
+ <a name="id-1.7.2.9.6.6.6"></a><h4>Returns</h4>
657
+ <p> a <span class="type">GOptionGroup</span> for the commandline arguments
658
+ recognized by Clutter. </p>
659
+ <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
660
+ </div>
1079
661
  <p class="since">Since 0.8.2</p>
1080
662
  </div>
1081
663
  <hr>
1082
664
  <div class="refsect2">
1083
- <a name="clutter-main"></a><h3>clutter_main ()</h3>
1084
- <pre class="programlisting"><span class="returnvalue">void</span> clutter_main (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1085
- <p>
1086
- Starts the Clutter mainloop.
1087
- </p>
665
+ <a name="clutter-main"></a><h3>clutter_main ()</h3>
666
+ <pre class="programlisting"><span class="returnvalue">void</span>
667
+ clutter_main (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
668
+ <p>Starts the Clutter mainloop.</p>
1088
669
  </div>
1089
670
  <hr>
1090
671
  <div class="refsect2">
1091
- <a name="clutter-main-quit"></a><h3>clutter_main_quit ()</h3>
1092
- <pre class="programlisting"><span class="returnvalue">void</span> clutter_main_quit (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1093
- <p>
1094
- Terminates the Clutter mainloop.
1095
- </p>
672
+ <a name="clutter-main-quit"></a><h3>clutter_main_quit ()</h3>
673
+ <pre class="programlisting"><span class="returnvalue">void</span>
674
+ clutter_main_quit (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
675
+ <p>Terminates the Clutter mainloop.</p>
1096
676
  </div>
1097
677
  <hr>
1098
678
  <div class="refsect2">
1099
- <a name="clutter-main-level"></a><h3>clutter_main_level ()</h3>
1100
- <pre class="programlisting"><span class="returnvalue">gint</span> clutter_main_level (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1101
- <p>
1102
- Retrieves the depth of the Clutter mainloop.
1103
- </p>
1104
- <div class="variablelist"><table border="0" class="variablelist">
1105
- <colgroup>
1106
- <col align="left" valign="top">
1107
- <col>
1108
- </colgroup>
1109
- <tbody><tr>
1110
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1111
- <td>The level of the mainloop.</td>
1112
- </tr></tbody>
1113
- </table></div>
679
+ <a name="clutter-main-level"></a><h3>clutter_main_level ()</h3>
680
+ <pre class="programlisting"><span class="returnvalue">gint</span>
681
+ clutter_main_level (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
682
+ <p>Retrieves the depth of the Clutter mainloop.</p>
683
+ <div class="refsect3">
684
+ <a name="id-1.7.2.9.6.9.5"></a><h4>Returns</h4>
685
+ <p> The level of the mainloop.</p>
686
+ <p></p>
687
+ </div>
1114
688
  </div>
1115
689
  <hr>
1116
690
  <div class="refsect2">
1117
- <a name="clutter-get-debug-enabled"></a><h3>clutter_get_debug_enabled ()</h3>
1118
- <pre class="programlisting"><span class="returnvalue">gboolean</span> clutter_get_debug_enabled (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
691
+ <a name="clutter-get-debug-enabled"></a><h3>clutter_get_debug_enabled ()</h3>
692
+ <pre class="programlisting"><span class="returnvalue">gboolean</span>
693
+ clutter_get_debug_enabled (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1119
694
  <div class="warning">
1120
- <h3 class="title">Warning</h3>
1121
- <p><code class="literal">clutter_get_debug_enabled</code> has been deprecated since version 1.10 and should not be used in newly-written code. This function does not do anything.</p>
695
+ <p><code class="literal">clutter_get_debug_enabled</code> has been deprecated since version 1.10 and should not be used in newly-written code.</p>
696
+ <p>This function does not do anything.</p>
697
+ </div>
698
+ <p>Check if Clutter has debugging enabled.</p>
699
+ <div class="refsect3">
700
+ <a name="id-1.7.2.9.6.10.6"></a><h4>Returns</h4>
701
+ <p> <code class="literal">FALSE</code></p>
702
+ <p></p>
1122
703
  </div>
1123
- <p>
1124
- Check if Clutter has debugging enabled.
1125
- </p>
1126
- <div class="variablelist"><table border="0" class="variablelist">
1127
- <colgroup>
1128
- <col align="left" valign="top">
1129
- <col>
1130
- </colgroup>
1131
- <tbody><tr>
1132
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1133
- <td><code class="literal">FALSE</code></td>
1134
- </tr></tbody>
1135
- </table></div>
1136
704
  </div>
1137
705
  <hr>
1138
706
  <div class="refsect2">
1139
- <a name="clutter-get-show-fps"></a><h3>clutter_get_show_fps ()</h3>
1140
- <pre class="programlisting"><span class="returnvalue">gboolean</span> clutter_get_show_fps (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
707
+ <a name="clutter-get-show-fps"></a><h3>clutter_get_show_fps ()</h3>
708
+ <pre class="programlisting"><span class="returnvalue">gboolean</span>
709
+ clutter_get_show_fps (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1141
710
  <div class="warning">
1142
- <h3 class="title">Warning</h3>
1143
- <p><code class="literal">clutter_get_show_fps</code> has been deprecated since version 1.10 and should not be used in newly-written code. This function does not do anything. Use the environment
711
+ <p><code class="literal">clutter_get_show_fps</code> has been deprecated since version 1.10 and should not be used in newly-written code.</p>
712
+ <p>This function does not do anything. Use the environment
1144
713
  variable or the configuration file to determine whether Clutter should
1145
714
  print out the FPS counter on the console.</p>
1146
715
  </div>
1147
- <p>
1148
- Returns whether Clutter should print out the frames per second on the
716
+ <p>Returns whether Clutter should print out the frames per second on the
1149
717
  console. You can enable this setting either using the
1150
- <code class="literal">CLUTTER_SHOW_FPS</code> environment variable or passing
1151
- the <code class="literal">--clutter-show-fps</code> command line argument. *
1152
- </p>
1153
- <div class="variablelist"><table border="0" class="variablelist">
1154
- <colgroup>
1155
- <col align="left" valign="top">
1156
- <col>
1157
- </colgroup>
1158
- <tbody><tr>
1159
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1160
- <td>
1161
- <code class="literal">TRUE</code> if Clutter should show the FPS.</td>
1162
- </tr></tbody>
1163
- </table></div>
718
+ &lt;literal&gt;CLUTTER_SHOW_FPS&lt;/literal&gt; environment variable or passing
719
+ the &lt;literal&gt;--clutter-show-fps&lt;/literal&gt; command line argument. *</p>
720
+ <div class="refsect3">
721
+ <a name="id-1.7.2.9.6.11.7"></a><h4>Returns</h4>
722
+ <p> <code class="literal">TRUE</code> if Clutter should show the FPS.</p>
723
+ <p></p>
724
+ </div>
1164
725
  <p class="since">Since 0.4</p>
1165
726
  </div>
1166
727
  <hr>
1167
728
  <div class="refsect2">
1168
- <a name="clutter-get-timestamp"></a><h3>clutter_get_timestamp ()</h3>
1169
- <pre class="programlisting"><span class="returnvalue">gulong</span> clutter_get_timestamp (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
729
+ <a name="clutter-get-timestamp"></a><h3>clutter_get_timestamp ()</h3>
730
+ <pre class="programlisting"><span class="returnvalue">gulong</span>
731
+ clutter_get_timestamp (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1170
732
  <div class="warning">
1171
- <h3 class="title">Warning</h3>
1172
- <p><code class="literal">clutter_get_timestamp</code> has been deprecated since version 1.10 and should not be used in newly-written code. Use <span class="type">GTimer</span> or <code class="function">g_get_monotonic_time()</code> for a proper
733
+ <p><code class="literal">clutter_get_timestamp</code> has been deprecated since version 1.10 and should not be used in newly-written code.</p>
734
+ <p>Use <span class="type">GTimer</span> or <code class="function">g_get_monotonic_time()</code> for a proper
1173
735
  timing source</p>
1174
736
  </div>
1175
- <p>
1176
- Returns the approximate number of microseconds passed since Clutter was
1177
- intialised.
1178
- </p>
1179
- <p>
1180
- This function shdould not be used by application code.
1181
- </p>
1182
- <p>
1183
- The output of this function depends on whether Clutter was configured to
1184
- enable its debugging code paths, so it's less useful than intended.
1185
- </p>
1186
- <p>
1187
- Since Clutter 1.10, this function is an alias to <code class="function">g_get_monotonic_time()</code>
1188
- if Clutter was configured to enable the debugging code paths.
1189
- </p>
1190
- <div class="variablelist"><table border="0" class="variablelist">
1191
- <colgroup>
1192
- <col align="left" valign="top">
1193
- <col>
1194
- </colgroup>
1195
- <tbody><tr>
1196
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1197
- <td>Number of microseconds since <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a> was called, or
1198
- zero if Clutter was not configured with debugging code paths.</td>
1199
- </tr></tbody>
1200
- </table></div>
737
+ <p>Returns the approximate number of microseconds passed since Clutter was
738
+ intialised.</p>
739
+ <p>This function shdould not be used by application code.</p>
740
+ <p>The output of this function depends on whether Clutter was configured to
741
+ enable its debugging code paths, so it's less useful than intended.</p>
742
+ <p>Since Clutter 1.10, this function is an alias to <code class="function">g_get_monotonic_time()</code>
743
+ if Clutter was configured to enable the debugging code paths.</p>
744
+ <div class="refsect3">
745
+ <a name="id-1.7.2.9.6.12.9"></a><h4>Returns</h4>
746
+ <p> Number of microseconds since <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a> was called, or
747
+ zero if Clutter was not configured with debugging code paths.</p>
748
+ <p></p>
749
+ </div>
1201
750
  </div>
1202
751
  <hr>
1203
752
  <div class="refsect2">
1204
- <a name="clutter-get-actor-by-gid"></a><h3>clutter_get_actor_by_gid ()</h3>
1205
- <pre class="programlisting"><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="returnvalue">ClutterActor</span></a> * clutter_get_actor_by_gid (<em class="parameter"><code><span class="type">guint32</span> id_</code></em>);</pre>
753
+ <a name="clutter-get-actor-by-gid"></a><h3>clutter_get_actor_by_gid ()</h3>
754
+ <pre class="programlisting"><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="returnvalue">ClutterActor</span></a> *
755
+ clutter_get_actor_by_gid (<em class="parameter"><code><span class="type">guint32</span> id_</code></em>);</pre>
1206
756
  <div class="warning">
1207
- <h3 class="title">Warning</h3>
1208
- <p><code class="literal">clutter_get_actor_by_gid</code> has been deprecated since version 1.8 and should not be used in newly-written code. The id is not used any longer.</p>
1209
- </div>
1210
- <p>
1211
- Retrieves the <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> with <em class="parameter"><code>id_</code></em>.
1212
- </p>
1213
- <div class="variablelist"><table border="0" class="variablelist">
757
+ <p><code class="literal">clutter_get_actor_by_gid</code> has been deprecated since version 1.8 and should not be used in newly-written code.</p>
758
+ <p>The id is not used any longer.</p>
759
+ </div>
760
+ <p>Retrieves the <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> with <em class="parameter"><code>id_</code></em>
761
+ .</p>
762
+ <div class="refsect3">
763
+ <a name="id-1.7.2.9.6.13.7"></a><h4>Parameters</h4>
764
+ <div class="informaltable"><table width="100%" border="0">
1214
765
  <colgroup>
1215
- <col align="left" valign="top">
1216
- <col>
766
+ <col width="150px" class="parameters_name">
767
+ <col class="parameters_description">
768
+ <col width="200px" class="parameters_annotations">
1217
769
  </colgroup>
1218
- <tbody>
1219
- <tr>
1220
- <td><p><span class="term"><em class="parameter"><code>id_</code></em> :</span></p></td>
1221
- <td>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> unique id.</td>
1222
- </tr>
1223
- <tr>
1224
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1225
- <td>the actor with the passed id or <code class="literal">NULL</code>.
1226
- The returned actor does not have its reference count increased. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1227
- </td>
1228
- </tr>
1229
- </tbody>
770
+ <tbody><tr>
771
+ <td class="parameter_name"><p>id_</p></td>
772
+ <td class="parameter_description"><p>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> unique id.</p></td>
773
+ <td class="parameter_annotations"> </td>
774
+ </tr></tbody>
1230
775
  </table></div>
776
+ </div>
777
+ <div class="refsect3">
778
+ <a name="id-1.7.2.9.6.13.8"></a><h4>Returns</h4>
779
+ <p> the actor with the passed id or <code class="literal">NULL</code>.
780
+ The returned actor does not have its reference count increased. </p>
781
+ <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
782
+ </div>
1231
783
  <p class="since">Since 0.6</p>
1232
784
  </div>
1233
785
  <hr>
1234
786
  <div class="refsect2">
1235
- <a name="clutter-set-default-frame-rate"></a><h3>clutter_set_default_frame_rate ()</h3>
1236
- <pre class="programlisting"><span class="returnvalue">void</span> clutter_set_default_frame_rate (<em class="parameter"><code><span class="type">guint</span> frames_per_sec</code></em>);</pre>
787
+ <a name="clutter-set-default-frame-rate"></a><h3>clutter_set_default_frame_rate ()</h3>
788
+ <pre class="programlisting"><span class="returnvalue">void</span>
789
+ clutter_set_default_frame_rate (<em class="parameter"><code><span class="type">guint</span> frames_per_sec</code></em>);</pre>
1237
790
  <div class="warning">
1238
- <h3 class="title">Warning</h3>
1239
- <p><code class="literal">clutter_set_default_frame_rate</code> has been deprecated since version 1.10 and should not be used in newly-written code. This function does not do anything any more.</p>
791
+ <p><code class="literal">clutter_set_default_frame_rate</code> has been deprecated since version 1.10 and should not be used in newly-written code.</p>
792
+ <p>This function does not do anything any more.</p>
1240
793
  </div>
1241
- <p>
1242
- Sets the default frame rate. This frame rate will be used to limit
794
+ <p>Sets the default frame rate. This frame rate will be used to limit
1243
795
  the number of frames drawn if Clutter is not able to synchronize
1244
796
  with the vertical refresh rate of the display. When synchronization
1245
- is possible, this value is ignored.
1246
- </p>
1247
- <div class="variablelist"><table border="0" class="variablelist">
797
+ is possible, this value is ignored.</p>
798
+ <div class="refsect3">
799
+ <a name="id-1.7.2.9.6.14.7"></a><h4>Parameters</h4>
800
+ <div class="informaltable"><table width="100%" border="0">
1248
801
  <colgroup>
1249
- <col align="left" valign="top">
1250
- <col>
802
+ <col width="150px" class="parameters_name">
803
+ <col class="parameters_description">
804
+ <col width="200px" class="parameters_annotations">
1251
805
  </colgroup>
1252
806
  <tbody><tr>
1253
- <td><p><span class="term"><em class="parameter"><code>frames_per_sec</code></em> :</span></p></td>
1254
- <td>the new default frame rate</td>
807
+ <td class="parameter_name"><p>frames_per_sec</p></td>
808
+ <td class="parameter_description"><p>the new default frame rate</p></td>
809
+ <td class="parameter_annotations"> </td>
1255
810
  </tr></tbody>
1256
811
  </table></div>
812
+ </div>
1257
813
  <p class="since">Since 0.6</p>
1258
814
  </div>
1259
815
  <hr>
1260
816
  <div class="refsect2">
1261
- <a name="clutter-get-default-frame-rate"></a><h3>clutter_get_default_frame_rate ()</h3>
1262
- <pre class="programlisting"><span class="returnvalue">guint</span> clutter_get_default_frame_rate (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1263
- <p>
1264
- Retrieves the default frame rate. See <a class="link" href="clutter-General.html#clutter-set-default-frame-rate" title="clutter_set_default_frame_rate ()"><code class="function">clutter_set_default_frame_rate()</code></a>.
1265
- </p>
1266
- <div class="variablelist"><table border="0" class="variablelist">
1267
- <colgroup>
1268
- <col align="left" valign="top">
1269
- <col>
1270
- </colgroup>
1271
- <tbody><tr>
1272
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1273
- <td>the default frame rate</td>
1274
- </tr></tbody>
1275
- </table></div>
817
+ <a name="clutter-get-default-frame-rate"></a><h3>clutter_get_default_frame_rate ()</h3>
818
+ <pre class="programlisting"><span class="returnvalue">guint</span>
819
+ clutter_get_default_frame_rate (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
820
+ <p>Retrieves the default frame rate. See <a class="link" href="clutter-General.html#clutter-set-default-frame-rate" title="clutter_set_default_frame_rate ()"><code class="function">clutter_set_default_frame_rate()</code></a>.</p>
821
+ <div class="refsect3">
822
+ <a name="id-1.7.2.9.6.15.5"></a><h4>Returns</h4>
823
+ <p> the default frame rate</p>
824
+ <p></p>
825
+ </div>
1276
826
  <p class="since">Since 0.6</p>
1277
827
  </div>
1278
828
  <hr>
1279
829
  <div class="refsect2">
1280
- <a name="clutter-set-motion-events-enabled"></a><h3>clutter_set_motion_events_enabled ()</h3>
1281
- <pre class="programlisting"><span class="returnvalue">void</span> clutter_set_motion_events_enabled (<em class="parameter"><code><span class="type">gboolean</span> enable</code></em>);</pre>
830
+ <a name="clutter-set-motion-events-enabled"></a><h3>clutter_set_motion_events_enabled ()</h3>
831
+ <pre class="programlisting"><span class="returnvalue">void</span>
832
+ clutter_set_motion_events_enabled (<em class="parameter"><code><span class="type">gboolean</span> enable</code></em>);</pre>
1282
833
  <div class="warning">
1283
- <h3 class="title">Warning</h3>
1284
- <p><code class="literal">clutter_set_motion_events_enabled</code> has been deprecated since version 1.8 and should not be used in newly-written code. Use <a class="link" href="ClutterStage.html#clutter-stage-set-motion-events-enabled" title="clutter_stage_set_motion_events_enabled ()"><code class="function">clutter_stage_set_motion_events_enabled()</code></a> instead.</p>
1285
- </div>
1286
- <p>
1287
- Sets whether per-actor motion events should be enabled or not on
1288
- all <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a>s managed by Clutter.
1289
- </p>
1290
- <p>
1291
- If <em class="parameter"><code>enable</code></em> is <code class="literal">FALSE</code> the following events will not work:
1292
- </p>
834
+ <p><code class="literal">clutter_set_motion_events_enabled</code> has been deprecated since version 1.8 and should not be used in newly-written code.</p>
835
+ <p>Use <a class="link" href="ClutterStage.html#clutter-stage-set-motion-events-enabled" title="clutter_stage_set_motion_events_enabled ()"><code class="function">clutter_stage_set_motion_events_enabled()</code></a> instead.</p>
836
+ </div>
837
+ <p>Sets whether per-actor motion events should be enabled or not on
838
+ all <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a>&lt;!-- --&gt;s managed by Clutter.</p>
839
+ <p>If <em class="parameter"><code>enable</code></em>
840
+ is <code class="literal">FALSE</code> the following events will not work:</p>
1293
841
  <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
1294
- <li class="listitem"><p>ClutterActor::motion-event, unless on the
1295
- <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a></p></li>
842
+ <li class="listitem"><p>ClutterActor::motion-event, except on the <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a></p></li>
1296
843
  <li class="listitem"><p>ClutterActor::enter-event</p></li>
1297
844
  <li class="listitem"><p>ClutterActor::leave-event</p></li>
1298
845
  </ul></div>
1299
- <p>
1300
- </p>
1301
- <div class="variablelist"><table border="0" class="variablelist">
846
+ <div class="refsect3">
847
+ <a name="id-1.7.2.9.6.16.9"></a><h4>Parameters</h4>
848
+ <div class="informaltable"><table width="100%" border="0">
1302
849
  <colgroup>
1303
- <col align="left" valign="top">
1304
- <col>
850
+ <col width="150px" class="parameters_name">
851
+ <col class="parameters_description">
852
+ <col width="200px" class="parameters_annotations">
1305
853
  </colgroup>
1306
854
  <tbody><tr>
1307
- <td><p><span class="term"><em class="parameter"><code>enable</code></em> :</span></p></td>
1308
- <td>
1309
- <code class="literal">TRUE</code> to enable per-actor motion events</td>
855
+ <td class="parameter_name"><p>enable</p></td>
856
+ <td class="parameter_description"><p><code class="literal">TRUE</code> to enable per-actor motion events</p></td>
857
+ <td class="parameter_annotations"> </td>
1310
858
  </tr></tbody>
1311
859
  </table></div>
860
+ </div>
1312
861
  <p class="since">Since 0.6</p>
1313
862
  </div>
1314
863
  <hr>
1315
864
  <div class="refsect2">
1316
- <a name="clutter-get-motion-events-enabled"></a><h3>clutter_get_motion_events_enabled ()</h3>
1317
- <pre class="programlisting"><span class="returnvalue">gboolean</span> clutter_get_motion_events_enabled (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
865
+ <a name="clutter-get-motion-events-enabled"></a><h3>clutter_get_motion_events_enabled ()</h3>
866
+ <pre class="programlisting"><span class="returnvalue">gboolean</span>
867
+ clutter_get_motion_events_enabled (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1318
868
  <div class="warning">
1319
- <h3 class="title">Warning</h3>
1320
- <p><code class="literal">clutter_get_motion_events_enabled</code> has been deprecated since version 1.8 and should not be used in newly-written code. Use <a class="link" href="ClutterStage.html#clutter-stage-get-motion-events-enabled" title="clutter_stage_get_motion_events_enabled ()"><code class="function">clutter_stage_get_motion_events_enabled()</code></a> instead.</p>
869
+ <p><code class="literal">clutter_get_motion_events_enabled</code> has been deprecated since version 1.8 and should not be used in newly-written code.</p>
870
+ <p>Use <a class="link" href="ClutterStage.html#clutter-stage-get-motion-events-enabled" title="clutter_stage_get_motion_events_enabled ()"><code class="function">clutter_stage_get_motion_events_enabled()</code></a> instead.</p>
871
+ </div>
872
+ <p>Gets whether the per-actor motion events are enabled.</p>
873
+ <div class="refsect3">
874
+ <a name="id-1.7.2.9.6.17.7"></a><h4>Returns</h4>
875
+ <p> <code class="literal">TRUE</code> if the motion events are enabled</p>
876
+ <p></p>
1321
877
  </div>
1322
- <p>
1323
- Gets whether the per-actor motion events are enabled.
1324
- </p>
1325
- <div class="variablelist"><table border="0" class="variablelist">
1326
- <colgroup>
1327
- <col align="left" valign="top">
1328
- <col>
1329
- </colgroup>
1330
- <tbody><tr>
1331
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1332
- <td>
1333
- <code class="literal">TRUE</code> if the motion events are enabled</td>
1334
- </tr></tbody>
1335
- </table></div>
1336
878
  <p class="since">Since 0.6</p>
1337
879
  </div>
1338
880
  <hr>
1339
881
  <div class="refsect2">
1340
- <a name="clutter-clear-glyph-cache"></a><h3>clutter_clear_glyph_cache ()</h3>
1341
- <pre class="programlisting"><span class="returnvalue">void</span> clutter_clear_glyph_cache (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
882
+ <a name="clutter-clear-glyph-cache"></a><h3>clutter_clear_glyph_cache ()</h3>
883
+ <pre class="programlisting"><span class="returnvalue">void</span>
884
+ clutter_clear_glyph_cache (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1342
885
  <div class="warning">
1343
- <h3 class="title">Warning</h3>
1344
- <p><code class="literal">clutter_clear_glyph_cache</code> has been deprecated since version 1.10 and should not be used in newly-written code. Use <a class="link" href="clutter-General.html#clutter-get-font-map" title="clutter_get_font_map ()"><code class="function">clutter_get_font_map()</code></a> and
886
+ <p><code class="literal">clutter_clear_glyph_cache</code> has been deprecated since version 1.10 and should not be used in newly-written code.</p>
887
+ <p>Use <a class="link" href="clutter-General.html#clutter-get-font-map" title="clutter_get_font_map ()"><code class="function">clutter_get_font_map()</code></a> and
1345
888
  <code class="function">cogl_pango_font_map_clear_glyph_cache()</code> instead.</p>
1346
889
  </div>
1347
- <p>
1348
- Clears the internal cache of glyphs used by the Pango
890
+ <p>Clears the internal cache of glyphs used by the Pango
1349
891
  renderer. This will free up some memory and GL texture
1350
892
  resources. The cache will be automatically refilled as more text is
1351
- drawn.
1352
- </p>
893
+ drawn.</p>
1353
894
  <p class="since">Since 0.8</p>
1354
895
  </div>
1355
896
  <hr>
1356
897
  <div class="refsect2">
1357
- <a name="ClutterFontFlags"></a><h3>enum ClutterFontFlags</h3>
1358
- <pre class="programlisting">typedef enum {
1359
- /*&lt; prefix=CLUTTER_FONT &gt;*/
1360
- CLUTTER_FONT_MIPMAPPING = (1 &lt;&lt; 0),
1361
- CLUTTER_FONT_HINTING = (1 &lt;&lt; 1)
1362
- } ClutterFontFlags;
1363
- </pre>
1364
- <p>
1365
- Runtime flags to change the font quality. To be used with
1366
- <a class="link" href="clutter-General.html#clutter-set-font-flags" title="clutter_set_font_flags ()"><code class="function">clutter_set_font_flags()</code></a>.
1367
- </p>
1368
- <div class="variablelist"><table border="0" class="variablelist">
1369
- <colgroup>
1370
- <col align="left" valign="top">
1371
- <col>
1372
- </colgroup>
1373
- <tbody>
1374
- <tr>
1375
- <td><p><a name="CLUTTER-FONT-MIPMAPPING:CAPS"></a><span class="term"><code class="literal">CLUTTER_FONT_MIPMAPPING</code></span></p></td>
1376
- <td>Set to use mipmaps for the glyph cache textures.
1377
- </td>
1378
- </tr>
1379
- <tr>
1380
- <td><p><a name="CLUTTER-FONT-HINTING:CAPS"></a><span class="term"><code class="literal">CLUTTER_FONT_HINTING</code></span></p></td>
1381
- <td>Set to enable hinting on the glyphs.
1382
- </td>
1383
- </tr>
1384
- </tbody>
1385
- </table></div>
1386
- <p class="since">Since 1.0</p>
1387
- </div>
1388
- <hr>
1389
- <div class="refsect2">
1390
- <a name="clutter-set-font-flags"></a><h3>clutter_set_font_flags ()</h3>
1391
- <pre class="programlisting"><span class="returnvalue">void</span> clutter_set_font_flags (<em class="parameter"><code><a class="link" href="clutter-General.html#ClutterFontFlags" title="enum ClutterFontFlags"><span class="type">ClutterFontFlags</span></a> flags</code></em>);</pre>
898
+ <a name="clutter-set-font-flags"></a><h3>clutter_set_font_flags ()</h3>
899
+ <pre class="programlisting"><span class="returnvalue">void</span>
900
+ clutter_set_font_flags (<em class="parameter"><code><a class="link" href="clutter-General.html#ClutterFontFlags" title="enum ClutterFontFlags"><span class="type">ClutterFontFlags</span></a> flags</code></em>);</pre>
1392
901
  <div class="warning">
1393
- <h3 class="title">Warning</h3>
1394
- <p><code class="literal">clutter_set_font_flags</code> has been deprecated since version 1.10 and should not be used in newly-written code. Use <a class="link" href="ClutterBackend.html#clutter-backend-set-font-options" title="clutter_backend_set_font_options ()"><code class="function">clutter_backend_set_font_options()</code></a> and the
902
+ <p><code class="literal">clutter_set_font_flags</code> has been deprecated since version 1.10 and should not be used in newly-written code.</p>
903
+ <p>Use <a class="link" href="ClutterBackend.html#clutter-backend-set-font-options" title="clutter_backend_set_font_options ()"><code class="function">clutter_backend_set_font_options()</code></a> and the
1395
904
  <span class="type">cairo_font_option_t</span> API.</p>
1396
905
  </div>
1397
- <p>
1398
- Sets the font quality options for subsequent text rendering
1399
- operations.
1400
- </p>
1401
- <p>
1402
- Using mipmapped textures will improve the quality for scaled down
1403
- text but will use more texture memory.
1404
- </p>
1405
- <p>
1406
- Enabling hinting improves text quality for static text but may
1407
- introduce some artifacts if the text is animated.
1408
- </p>
1409
- <div class="variablelist"><table border="0" class="variablelist">
906
+ <p>Sets the font quality options for subsequent text rendering
907
+ operations.</p>
908
+ <p>Using mipmapped textures will improve the quality for scaled down
909
+ text but will use more texture memory.</p>
910
+ <p>Enabling hinting improves text quality for static text but may
911
+ introduce some artifacts if the text is animated.</p>
912
+ <div class="refsect3">
913
+ <a name="id-1.7.2.9.6.19.9"></a><h4>Parameters</h4>
914
+ <div class="informaltable"><table width="100%" border="0">
1410
915
  <colgroup>
1411
- <col align="left" valign="top">
1412
- <col>
916
+ <col width="150px" class="parameters_name">
917
+ <col class="parameters_description">
918
+ <col width="200px" class="parameters_annotations">
1413
919
  </colgroup>
1414
920
  <tbody><tr>
1415
- <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
1416
- <td>The new flags</td>
921
+ <td class="parameter_name"><p>flags</p></td>
922
+ <td class="parameter_description"><p>The new flags</p></td>
923
+ <td class="parameter_annotations"> </td>
1417
924
  </tr></tbody>
1418
925
  </table></div>
926
+ </div>
1419
927
  <p class="since">Since 1.0</p>
1420
928
  </div>
1421
929
  <hr>
1422
930
  <div class="refsect2">
1423
- <a name="clutter-get-font-flags"></a><h3>clutter_get_font_flags ()</h3>
1424
- <pre class="programlisting"><a class="link" href="clutter-General.html#ClutterFontFlags" title="enum ClutterFontFlags"><span class="returnvalue">ClutterFontFlags</span></a> clutter_get_font_flags (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
931
+ <a name="clutter-get-font-flags"></a><h3>clutter_get_font_flags ()</h3>
932
+ <pre class="programlisting"><a class="link" href="clutter-General.html#ClutterFontFlags" title="enum ClutterFontFlags"><span class="returnvalue">ClutterFontFlags</span></a>
933
+ clutter_get_font_flags (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1425
934
  <div class="warning">
1426
- <h3 class="title">Warning</h3>
1427
- <p><code class="literal">clutter_get_font_flags</code> has been deprecated since version 1.10 and should not be used in newly-written code. Use <a class="link" href="ClutterBackend.html#clutter-backend-get-font-options" title="clutter_backend_get_font_options ()"><code class="function">clutter_backend_get_font_options()</code></a> and the
1428
- <a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-font-options-t.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a> API.</p>
1429
- </div>
1430
- <p>
1431
- Gets the current font flags for rendering text. See
1432
- <a class="link" href="clutter-General.html#clutter-set-font-flags" title="clutter_set_font_flags ()"><code class="function">clutter_set_font_flags()</code></a>.
1433
- </p>
1434
- <div class="variablelist"><table border="0" class="variablelist">
1435
- <colgroup>
1436
- <col align="left" valign="top">
1437
- <col>
1438
- </colgroup>
1439
- <tbody><tr>
1440
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1441
- <td>The font flags</td>
1442
- </tr></tbody>
1443
- </table></div>
935
+ <p><code class="literal">clutter_get_font_flags</code> has been deprecated since version 1.10 and should not be used in newly-written code.</p>
936
+ <p>Use <a class="link" href="ClutterBackend.html#clutter-backend-get-font-options" title="clutter_backend_get_font_options ()"><code class="function">clutter_backend_get_font_options()</code></a> and the
937
+ <span class="type">cairo_font_options_t</span> API.</p>
938
+ </div>
939
+ <p>Gets the current font flags for rendering text. See
940
+ <a class="link" href="clutter-General.html#clutter-set-font-flags" title="clutter_set_font_flags ()"><code class="function">clutter_set_font_flags()</code></a>.</p>
941
+ <div class="refsect3">
942
+ <a name="id-1.7.2.9.6.20.7"></a><h4>Returns</h4>
943
+ <p> The font flags</p>
944
+ <p></p>
945
+ </div>
1444
946
  <p class="since">Since 1.0</p>
1445
947
  </div>
1446
948
  <hr>
1447
949
  <div class="refsect2">
1448
- <a name="clutter-get-font-map"></a><h3>clutter_get_font_map ()</h3>
1449
- <pre class="programlisting"><span class="returnvalue">PangoFontMap</span> * clutter_get_font_map (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1450
- <p>
1451
- Retrieves the <span class="type">PangoFontMap</span> instance used by Clutter.
950
+ <a name="clutter-get-font-map"></a><h3>clutter_get_font_map ()</h3>
951
+ <pre class="programlisting"><span class="returnvalue">PangoFontMap</span> *
952
+ clutter_get_font_map (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
953
+ <p>Retrieves the <span class="type">PangoFontMap</span> instance used by Clutter.
1452
954
  You can use the global font map object with the COGL
1453
- Pango API.
1454
- </p>
1455
- <div class="variablelist"><table border="0" class="variablelist">
1456
- <colgroup>
1457
- <col align="left" valign="top">
1458
- <col>
1459
- </colgroup>
1460
- <tbody><tr>
1461
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1462
- <td>the <span class="type">PangoFontMap</span> instance. The returned
1463
- value is owned by Clutter and it should never be unreferenced. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1464
- </td>
1465
- </tr></tbody>
1466
- </table></div>
955
+ Pango API.</p>
956
+ <div class="refsect3">
957
+ <a name="id-1.7.2.9.6.21.5"></a><h4>Returns</h4>
958
+ <p> the <span class="type">PangoFontMap</span> instance. The returned
959
+ value is owned by Clutter and it should never be unreferenced. </p>
960
+ <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
961
+ </div>
1467
962
  <p class="since">Since 1.0</p>
1468
963
  </div>
1469
964
  <hr>
1470
965
  <div class="refsect2">
1471
- <a name="ClutterTextDirection"></a><h3>enum ClutterTextDirection</h3>
1472
- <pre class="programlisting">typedef enum {
1473
- CLUTTER_TEXT_DIRECTION_DEFAULT,
1474
- CLUTTER_TEXT_DIRECTION_LTR,
1475
- CLUTTER_TEXT_DIRECTION_RTL
1476
- } ClutterTextDirection;
1477
- </pre>
1478
- <p>
1479
- The text direction to be used by <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>s
1480
- </p>
1481
- <div class="variablelist"><table border="0" class="variablelist">
1482
- <colgroup>
1483
- <col align="left" valign="top">
1484
- <col>
1485
- </colgroup>
1486
- <tbody>
1487
- <tr>
1488
- <td><p><a name="CLUTTER-TEXT-DIRECTION-DEFAULT:CAPS"></a><span class="term"><code class="literal">CLUTTER_TEXT_DIRECTION_DEFAULT</code></span></p></td>
1489
- <td>Use the default setting, as returned
1490
- by <a class="link" href="clutter-General.html#clutter-get-default-text-direction" title="clutter_get_default_text_direction ()"><code class="function">clutter_get_default_text_direction()</code></a>
1491
- </td>
1492
- </tr>
1493
- <tr>
1494
- <td><p><a name="CLUTTER-TEXT-DIRECTION-LTR:CAPS"></a><span class="term"><code class="literal">CLUTTER_TEXT_DIRECTION_LTR</code></span></p></td>
1495
- <td>Use left-to-right text direction
1496
- </td>
1497
- </tr>
1498
- <tr>
1499
- <td><p><a name="CLUTTER-TEXT-DIRECTION-RTL:CAPS"></a><span class="term"><code class="literal">CLUTTER_TEXT_DIRECTION_RTL</code></span></p></td>
1500
- <td>Use right-to-left text direction
1501
- </td>
1502
- </tr>
1503
- </tbody>
1504
- </table></div>
1505
- <p class="since">Since 1.2</p>
966
+ <a name="clutter-get-default-text-direction"></a><h3>clutter_get_default_text_direction ()</h3>
967
+ <pre class="programlisting"><a class="link" href="clutter-General.html#ClutterTextDirection" title="enum ClutterTextDirection"><span class="returnvalue">ClutterTextDirection</span></a>
968
+ clutter_get_default_text_direction (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
969
+ <p>Retrieves the default direction for the text. The text direction is
970
+ determined by the locale and/or by the &lt;varname&gt;CLUTTER_TEXT_DIRECTION&lt;/varname&gt;
971
+ environment variable.</p>
972
+ <p>The default text direction can be overridden on a per-actor basis by using
973
+ <a class="link" href="ClutterActor.html#clutter-actor-set-text-direction" title="clutter_actor_set_text_direction ()"><code class="function">clutter_actor_set_text_direction()</code></a>.</p>
974
+ <div class="refsect3">
975
+ <a name="id-1.7.2.9.6.22.6"></a><h4>Returns</h4>
976
+ <p> the default text direction</p>
977
+ <p></p>
1506
978
  </div>
1507
- <hr>
1508
- <div class="refsect2">
1509
- <a name="clutter-get-default-text-direction"></a><h3>clutter_get_default_text_direction ()</h3>
1510
- <pre class="programlisting"><a class="link" href="clutter-General.html#ClutterTextDirection" title="enum ClutterTextDirection"><span class="returnvalue">ClutterTextDirection</span></a> clutter_get_default_text_direction (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1511
- <p>
1512
- Retrieves the default direction for the text. The text direction is
1513
- determined by the locale and/or by the <code class="varname">CLUTTER_TEXT_DIRECTION</code>
1514
- environment variable.
1515
- </p>
1516
- <p>
1517
- The default text direction can be overridden on a per-actor basis by using
1518
- <a class="link" href="ClutterActor.html#clutter-actor-set-text-direction" title="clutter_actor_set_text_direction ()"><code class="function">clutter_actor_set_text_direction()</code></a>.
1519
- </p>
1520
- <div class="variablelist"><table border="0" class="variablelist">
1521
- <colgroup>
1522
- <col align="left" valign="top">
1523
- <col>
1524
- </colgroup>
1525
- <tbody><tr>
1526
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1527
- <td>the default text direction</td>
1528
- </tr></tbody>
1529
- </table></div>
1530
979
  <p class="since">Since 1.2</p>
1531
980
  </div>
1532
981
  <hr>
1533
982
  <div class="refsect2">
1534
- <a name="clutter-get-accessibility-enabled"></a><h3>clutter_get_accessibility_enabled ()</h3>
1535
- <pre class="programlisting"><span class="returnvalue">gboolean</span> clutter_get_accessibility_enabled (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1536
- <p>
1537
- Returns whether Clutter has accessibility support enabled. As
983
+ <a name="clutter-get-accessibility-enabled"></a><h3>clutter_get_accessibility_enabled ()</h3>
984
+ <pre class="programlisting"><span class="returnvalue">gboolean</span>
985
+ clutter_get_accessibility_enabled (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
986
+ <p>Returns whether Clutter has accessibility support enabled. As
1538
987
  least, a value of TRUE means that there are a proper AtkUtil
1539
- implementation available
1540
- </p>
1541
- <div class="variablelist"><table border="0" class="variablelist">
1542
- <colgroup>
1543
- <col align="left" valign="top">
1544
- <col>
1545
- </colgroup>
1546
- <tbody><tr>
1547
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1548
- <td>
1549
- <code class="literal">TRUE</code> if Clutter has accessibility support enabled</td>
1550
- </tr></tbody>
1551
- </table></div>
988
+ implementation available</p>
989
+ <div class="refsect3">
990
+ <a name="id-1.7.2.9.6.23.5"></a><h4>Returns</h4>
991
+ <p> <code class="literal">TRUE</code> if Clutter has accessibility support enabled</p>
992
+ <p></p>
993
+ </div>
1552
994
  <p class="since">Since 1.4</p>
1553
995
  </div>
1554
996
  <hr>
1555
997
  <div class="refsect2">
1556
- <a name="clutter-disable-accessibility"></a><h3>clutter_disable_accessibility ()</h3>
1557
- <pre class="programlisting"><span class="returnvalue">void</span> clutter_disable_accessibility (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1558
- <p>
1559
- Disable loading the accessibility support. It has the same effect
998
+ <a name="clutter-disable-accessibility"></a><h3>clutter_disable_accessibility ()</h3>
999
+ <pre class="programlisting"><span class="returnvalue">void</span>
1000
+ clutter_disable_accessibility (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1001
+ <p>Disable loading the accessibility support. It has the same effect
1560
1002
  as setting the environment variable
1561
1003
  CLUTTER_DISABLE_ACCESSIBILITY. For the same reason, this method
1562
- should be called before <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a>.
1563
- </p>
1004
+ should be called before <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a>.</p>
1564
1005
  <p class="since">Since 1.14</p>
1565
1006
  </div>
1566
1007
  <hr>
1567
1008
  <div class="refsect2">
1568
- <a name="clutter-threads-set-lock-functions"></a><h3>clutter_threads_set_lock_functions ()</h3>
1569
- <pre class="programlisting"><span class="returnvalue">void</span> clutter_threads_set_lock_functions (<em class="parameter"><code><span class="type">GCallback</span> enter_fn</code></em>,
1570
- <em class="parameter"><code><span class="type">GCallback</span> leave_fn</code></em>);</pre>
1571
- <p>
1572
- Allows the application to replace the standard method that
1009
+ <a name="clutter-threads-set-lock-functions"></a><h3>clutter_threads_set_lock_functions ()</h3>
1010
+ <pre class="programlisting"><span class="returnvalue">void</span>
1011
+ clutter_threads_set_lock_functions (<em class="parameter"><code><span class="type">GCallback</span> enter_fn</code></em>,
1012
+ <em class="parameter"><code><span class="type">GCallback</span> leave_fn</code></em>);</pre>
1013
+ <p>Allows the application to replace the standard method that
1573
1014
  Clutter uses to protect its data structures. Normally, Clutter
1574
- creates a single <span class="type">GMutex</span> that is locked by <a class="link" href="clutter-General.html#clutter-threads-enter" title="clutter_threads_enter ()"><code class="function">clutter_threads_enter()</code></a>,
1575
- and released by <a class="link" href="clutter-General.html#clutter-threads-leave" title="clutter_threads_leave ()"><code class="function">clutter_threads_leave()</code></a>; using this function an
1576
- application provides, instead, a function <em class="parameter"><code>enter_fn</code></em> that is
1577
- called by <a class="link" href="clutter-General.html#clutter-threads-enter" title="clutter_threads_enter ()"><code class="function">clutter_threads_enter()</code></a> and a function <em class="parameter"><code>leave_fn</code></em> that is
1578
- called by <a class="link" href="clutter-General.html#clutter-threads-leave" title="clutter_threads_leave ()"><code class="function">clutter_threads_leave()</code></a>.
1579
- </p>
1580
- <p>
1581
- The functions must provide at least same locking functionality
1015
+ creates a single <span class="type">GMutex</span> that is locked by <a class="link" href="clutter-General.html#clutter-threads-enter" title="clutter_threads_enter ()"><code class="function">clutter_threads_enter()</code></a>,
1016
+ and released by <a class="link" href="clutter-General.html#clutter-threads-leave" title="clutter_threads_leave ()"><code class="function">clutter_threads_leave()</code></a>; using this function an
1017
+ application provides, instead, a function <em class="parameter"><code>enter_fn</code></em>
1018
+ that is
1019
+ called by <a class="link" href="clutter-General.html#clutter-threads-enter" title="clutter_threads_enter ()"><code class="function">clutter_threads_enter()</code></a> and a function <em class="parameter"><code>leave_fn</code></em>
1020
+ that is
1021
+ called by <a class="link" href="clutter-General.html#clutter-threads-leave" title="clutter_threads_leave ()"><code class="function">clutter_threads_leave()</code></a>.</p>
1022
+ <p>The functions must provide at least same locking functionality
1582
1023
  as the default implementation, but can also do extra application
1583
- specific processing.
1584
- </p>
1585
- <p>
1586
- As an example, consider an application that has its own recursive
1024
+ specific processing.</p>
1025
+ <p>As an example, consider an application that has its own recursive
1587
1026
  lock that when held, holds the Clutter lock as well. When Clutter
1588
1027
  unlocks the Clutter lock when entering a recursive main loop, the
1589
- application must temporarily release its lock as well.
1590
- </p>
1591
- <p>
1592
- Most threaded Clutter apps won't need to use this method.
1593
- </p>
1594
- <p>
1595
- This method must be called before <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a>, and cannot
1596
- be called multiple times.
1597
- </p>
1598
- <div class="variablelist"><table border="0" class="variablelist">
1028
+ application must temporarily release its lock as well.</p>
1029
+ <p>Most threaded Clutter apps won't need to use this method.</p>
1030
+ <p>This method must be called before <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a>, and cannot
1031
+ be called multiple times.</p>
1032
+ <div class="refsect3">
1033
+ <a name="id-1.7.2.9.6.25.9"></a><h4>Parameters</h4>
1034
+ <div class="informaltable"><table width="100%" border="0">
1599
1035
  <colgroup>
1600
- <col align="left" valign="top">
1601
- <col>
1036
+ <col width="150px" class="parameters_name">
1037
+ <col class="parameters_description">
1038
+ <col width="200px" class="parameters_annotations">
1602
1039
  </colgroup>
1603
1040
  <tbody>
1604
1041
  <tr>
1605
- <td><p><span class="term"><em class="parameter"><code>enter_fn</code></em> :</span></p></td>
1606
- <td>function called when aquiring the Clutter main lock</td>
1042
+ <td class="parameter_name"><p>enter_fn</p></td>
1043
+ <td class="parameter_description"><p>function called when aquiring the Clutter main lock</p></td>
1044
+ <td class="parameter_annotations"> </td>
1607
1045
  </tr>
1608
1046
  <tr>
1609
- <td><p><span class="term"><em class="parameter"><code>leave_fn</code></em> :</span></p></td>
1610
- <td>function called when releasing the Clutter main lock</td>
1047
+ <td class="parameter_name"><p>leave_fn</p></td>
1048
+ <td class="parameter_description"><p>function called when releasing the Clutter main lock</p></td>
1049
+ <td class="parameter_annotations"> </td>
1611
1050
  </tr>
1612
1051
  </tbody>
1613
1052
  </table></div>
1053
+ </div>
1614
1054
  <p class="since">Since 0.4</p>
1615
1055
  </div>
1616
1056
  <hr>
1617
1057
  <div class="refsect2">
1618
- <a name="clutter-threads-init"></a><h3>clutter_threads_init ()</h3>
1619
- <pre class="programlisting"><span class="returnvalue">void</span> clutter_threads_init (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1058
+ <a name="clutter-threads-init"></a><h3>clutter_threads_init ()</h3>
1059
+ <pre class="programlisting"><span class="returnvalue">void</span>
1060
+ clutter_threads_init (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1620
1061
  <div class="warning">
1621
- <h3 class="title">Warning</h3>
1622
- <p><code class="literal">clutter_threads_init</code> has been deprecated since version 1.10 and should not be used in newly-written code. This function does not do anything. Threading support
1062
+ <p><code class="literal">clutter_threads_init</code> has been deprecated since version 1.10 and should not be used in newly-written code.</p>
1063
+ <p>This function does not do anything. Threading support
1623
1064
  is initialized when Clutter is initialized.</p>
1624
1065
  </div>
1625
- <p>
1626
- Initialises the Clutter threading mechanism, so that Clutter API can be
1627
- called by multiple threads, using <a class="link" href="clutter-General.html#clutter-threads-enter" title="clutter_threads_enter ()"><code class="function">clutter_threads_enter()</code></a> and
1628
- <a class="link" href="clutter-General.html#clutter-threads-leave" title="clutter_threads_leave ()"><code class="function">clutter_threads_leave()</code></a> to mark the critical sections.
1629
- </p>
1630
- <p>
1631
- You must call <code class="function">g_thread_init()</code> before this function.
1632
- </p>
1633
- <p>
1634
- This function must be called before <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a>.
1635
- </p>
1636
- <p>
1637
- It is safe to call this function multiple times.
1638
- </p>
1066
+ <p>Initialises the Clutter threading mechanism, so that Clutter API can be
1067
+ called by multiple threads, using <a class="link" href="clutter-General.html#clutter-threads-enter" title="clutter_threads_enter ()"><code class="function">clutter_threads_enter()</code></a> and
1068
+ <a class="link" href="clutter-General.html#clutter-threads-leave" title="clutter_threads_leave ()"><code class="function">clutter_threads_leave()</code></a> to mark the critical sections.</p>
1069
+ <p>You must call <code class="function">g_thread_init()</code> before this function.</p>
1070
+ <p>This function must be called before <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a>.</p>
1071
+ <p>It is safe to call this function multiple times.</p>
1639
1072
  <p class="since">Since 0.4</p>
1640
1073
  </div>
1641
1074
  <hr>
1642
1075
  <div class="refsect2">
1643
- <a name="clutter-threads-enter"></a><h3>clutter_threads_enter ()</h3>
1644
- <pre class="programlisting"><span class="returnvalue">void</span> clutter_threads_enter (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1076
+ <a name="clutter-threads-enter"></a><h3>clutter_threads_enter ()</h3>
1077
+ <pre class="programlisting"><span class="returnvalue">void</span>
1078
+ clutter_threads_enter (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1645
1079
  <div class="warning">
1646
- <h3 class="title">Warning</h3>
1647
- <p><code class="literal">clutter_threads_enter</code> has been deprecated since version 1.12 and should not be used in newly-written code. This function should not be used by application
1080
+ <p><code class="literal">clutter_threads_enter</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
1081
+ <p>This function should not be used by application
1648
1082
  code; marking critical sections is not portable on various
1649
1083
  platforms. Instead of acquiring the Clutter lock, schedule UI
1650
- updates from the main loop using <a class="link" href="clutter-General.html#clutter-threads-add-idle" title="clutter_threads_add_idle ()"><code class="function">clutter_threads_add_idle()</code></a> or
1651
- <a class="link" href="clutter-General.html#clutter-threads-add-timeout" title="clutter_threads_add_timeout ()"><code class="function">clutter_threads_add_timeout()</code></a>.</p>
1084
+ updates from the main loop using <a class="link" href="clutter-General.html#clutter-threads-add-idle" title="clutter_threads_add_idle ()"><code class="function">clutter_threads_add_idle()</code></a> or
1085
+ <a class="link" href="clutter-General.html#clutter-threads-add-timeout" title="clutter_threads_add_timeout ()"><code class="function">clutter_threads_add_timeout()</code></a>.</p>
1652
1086
  </div>
1653
- <p>
1654
- Locks the Clutter thread lock.
1655
- </p>
1087
+ <p>Locks the Clutter thread lock.</p>
1656
1088
  <p class="since">Since 0.4</p>
1657
1089
  </div>
1658
1090
  <hr>
1659
1091
  <div class="refsect2">
1660
- <a name="clutter-threads-leave"></a><h3>clutter_threads_leave ()</h3>
1661
- <pre class="programlisting"><span class="returnvalue">void</span> clutter_threads_leave (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1092
+ <a name="clutter-threads-leave"></a><h3>clutter_threads_leave ()</h3>
1093
+ <pre class="programlisting"><span class="returnvalue">void</span>
1094
+ clutter_threads_leave (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1662
1095
  <div class="warning">
1663
- <h3 class="title">Warning</h3>
1664
- <p><code class="literal">clutter_threads_leave</code> has been deprecated since version 1.12 and should not be used in newly-written code. This function should not be used by application
1096
+ <p><code class="literal">clutter_threads_leave</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
1097
+ <p>This function should not be used by application
1665
1098
  code; marking critical sections is not portable on various
1666
1099
  platforms. Instead of acquiring the Clutter lock, schedule UI
1667
- updates from the main loop using <a class="link" href="clutter-General.html#clutter-threads-add-idle" title="clutter_threads_add_idle ()"><code class="function">clutter_threads_add_idle()</code></a> or
1668
- <a class="link" href="clutter-General.html#clutter-threads-add-timeout" title="clutter_threads_add_timeout ()"><code class="function">clutter_threads_add_timeout()</code></a>.</p>
1100
+ updates from the main loop using <a class="link" href="clutter-General.html#clutter-threads-add-idle" title="clutter_threads_add_idle ()"><code class="function">clutter_threads_add_idle()</code></a> or
1101
+ <a class="link" href="clutter-General.html#clutter-threads-add-timeout" title="clutter_threads_add_timeout ()"><code class="function">clutter_threads_add_timeout()</code></a>.</p>
1669
1102
  </div>
1670
- <p>
1671
- Unlocks the Clutter thread lock.
1672
- </p>
1103
+ <p>Unlocks the Clutter thread lock.</p>
1673
1104
  <p class="since">Since 0.4</p>
1674
1105
  </div>
1675
1106
  <hr>
1676
1107
  <div class="refsect2">
1677
- <a name="clutter-threads-add-idle"></a><h3>clutter_threads_add_idle ()</h3>
1678
- <pre class="programlisting"><span class="returnvalue">guint</span> clutter_threads_add_idle (<em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
1679
- <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
1680
- <p>
1681
- Simple wrapper around <a class="link" href="clutter-General.html#clutter-threads-add-idle-full" title="clutter_threads_add_idle_full ()"><code class="function">clutter_threads_add_idle_full()</code></a> using the
1682
- default priority.
1683
- </p>
1684
- <div class="variablelist"><table border="0" class="variablelist">
1108
+ <a name="clutter-threads-add-idle"></a><h3>clutter_threads_add_idle ()</h3>
1109
+ <pre class="programlisting"><span class="returnvalue">guint</span>
1110
+ clutter_threads_add_idle (<em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
1111
+ <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
1112
+ <p>Simple wrapper around <a class="link" href="clutter-General.html#clutter-threads-add-idle-full" title="clutter_threads_add_idle_full ()"><code class="function">clutter_threads_add_idle_full()</code></a> using the
1113
+ default priority.</p>
1114
+ <div class="refsect3">
1115
+ <a name="id-1.7.2.9.6.29.5"></a><h4>Parameters</h4>
1116
+ <div class="informaltable"><table width="100%" border="0">
1685
1117
  <colgroup>
1686
- <col align="left" valign="top">
1687
- <col>
1118
+ <col width="150px" class="parameters_name">
1119
+ <col class="parameters_description">
1120
+ <col width="200px" class="parameters_annotations">
1688
1121
  </colgroup>
1689
1122
  <tbody>
1690
1123
  <tr>
1691
- <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
1692
- <td>function to call</td>
1693
- </tr>
1694
- <tr>
1695
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1696
- <td>data to pass to the function</td>
1124
+ <td class="parameter_name"><p>func</p></td>
1125
+ <td class="parameter_description"><p>function to call</p></td>
1126
+ <td class="parameter_annotations"> </td>
1697
1127
  </tr>
1698
1128
  <tr>
1699
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1700
- <td>the ID (greater than 0) of the event source.</td>
1129
+ <td class="parameter_name"><p>data</p></td>
1130
+ <td class="parameter_description"><p>data to pass to the function</p></td>
1131
+ <td class="parameter_annotations"> </td>
1701
1132
  </tr>
1702
1133
  </tbody>
1703
1134
  </table></div>
1135
+ </div>
1136
+ <div class="refsect3">
1137
+ <a name="id-1.7.2.9.6.29.6"></a><h4>Returns</h4>
1138
+ <p> the ID (greater than 0) of the event source.</p>
1139
+ <p></p>
1140
+ </div>
1704
1141
  <p class="since">Since 0.4</p>
1705
1142
  </div>
1706
1143
  <hr>
1707
1144
  <div class="refsect2">
1708
- <a name="clutter-threads-add-idle-full"></a><h3>clutter_threads_add_idle_full ()</h3>
1709
- <pre class="programlisting"><span class="returnvalue">guint</span> clutter_threads_add_idle_full (<em class="parameter"><code><span class="type">gint</span> priority</code></em>,
1710
- <em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
1711
- <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
1712
- <em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);</pre>
1713
- <p>
1714
- Adds a function to be called whenever there are no higher priority
1145
+ <a name="clutter-threads-add-idle-full"></a><h3>clutter_threads_add_idle_full ()</h3>
1146
+ <pre class="programlisting"><span class="returnvalue">guint</span>
1147
+ clutter_threads_add_idle_full (<em class="parameter"><code><span class="type">gint</span> priority</code></em>,
1148
+ <em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
1149
+ <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
1150
+ <em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);</pre>
1151
+ <p>Adds a function to be called whenever there are no higher priority
1715
1152
  events pending. If the function returns <code class="literal">FALSE</code> it is automatically
1716
- removed from the list of event sources and will not be called again.
1717
- </p>
1718
- <p>
1719
- This function can be considered a thread-safe variant of <code class="function">g_idle_add_full()</code>:
1720
- it will call <em class="parameter"><code>function</code></em> while holding the Clutter lock. It is logically
1721
- equivalent to the following implementation:
1722
- </p>
1723
- <p>
1724
- </p>
1153
+ removed from the list of event sources and will not be called again.</p>
1154
+ <p>This function can be considered a thread-safe variant of <code class="function">g_idle_add_full()</code>:
1155
+ it will call <em class="parameter"><code>function</code></em>
1156
+ while holding the Clutter lock. It is logically
1157
+ equivalent to the following implementation:</p>
1725
1158
  <div class="informalexample">
1726
1159
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1727
1160
  <tbody>
@@ -1765,13 +1198,13 @@ equivalent to the following implementation:
1765
1198
  <span class="normal"> </span><span class="usertype">SafeClosure</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">closure </span><span class="symbol">=</span><span class="normal"> data</span><span class="symbol">;</span>
1766
1199
  <span class="normal"> </span><span class="usertype">gboolean</span><span class="normal"> res </span><span class="symbol">=</span><span class="normal"> FALSE</span><span class="symbol">;</span>
1767
1200
 
1768
- <span class="normal"> </span><span class="comment">/* mark the critical section */</span>
1201
+ <span class="normal"> </span><span class="comment">// mark the critical section //</span>
1769
1202
 
1770
1203
  <span class="normal"> </span><span class="function"><a href="clutter-General.html#clutter-threads-enter">clutter_threads_enter</a></span><span class="symbol">();</span>
1771
1204
 
1772
- <span class="normal"> </span><span class="comment">/* the callback does not need to acquire the Clutter</span>
1773
- <span class="comment"> * lock itself, as it is held by the this proxy handler</span>
1774
- <span class="comment"> */</span>
1205
+ <span class="normal"> </span><span class="comment">// the callback does not need to acquire the Clutter</span>
1206
+ <span class="normal"> </span><span class="symbol">/</span><span class="normal"> </span><span class="usertype">lock</span><span class="normal"> itself</span><span class="symbol">,</span><span class="normal"> as it is held by the this proxy handler</span>
1207
+ <span class="normal"> </span><span class="comment">//</span>
1775
1208
  <span class="normal"> res </span><span class="symbol">=</span><span class="normal"> closure</span><span class="symbol">-&gt;</span><span class="function">callback</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">closure</span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">);</span>
1776
1209
 
1777
1210
  <span class="normal"> </span><span class="function"><a href="clutter-General.html#clutter-threads-leave">clutter_threads_leave</a></span><span class="symbol">();</span>
@@ -1797,17 +1230,13 @@ equivalent to the following implementation:
1797
1230
  </table>
1798
1231
  </div>
1799
1232
 
1800
- <p>
1801
- </p>
1802
- <p>
1803
- This function should be used by threaded applications to make sure
1804
- that <em class="parameter"><code>func</code></em> is emitted under the Clutter threads lock and invoked
1233
+ <p></p>
1234
+ <p>This function should be used by threaded applications to make sure
1235
+ that <em class="parameter"><code>func</code></em>
1236
+ is emitted under the Clutter threads lock and invoked
1805
1237
  from the same thread that started the Clutter main loop. For instance,
1806
1238
  it can be used to update the UI using the results from a worker
1807
- thread:
1808
- </p>
1809
- <p>
1810
- </p>
1239
+ thread:</p>
1811
1240
  <div class="informalexample">
1812
1241
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1813
1242
  <tbody>
@@ -1845,10 +1274,10 @@ thread:
1845
1274
  <span class="cbracket">{</span>
1846
1275
  <span class="normal"> </span><span class="usertype">SomeClosure</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">closure </span><span class="symbol">=</span><span class="normal"> data</span><span class="symbol">;</span>
1847
1276
 
1848
- <span class="normal"> </span><span class="comment">/* it is safe to call Clutter API from this function because</span>
1849
- <span class="comment"> * it is invoked from the same thread that started the main</span>
1850
- <span class="comment"> * loop and under the Clutter thread lock</span>
1851
- <span class="comment"> */</span>
1277
+ <span class="normal"> </span><span class="comment">// it is safe to call Clutter API from this function because</span>
1278
+ <span class="normal"> </span><span class="symbol">/</span><span class="normal"> it is invoked from the same thread that started the main</span>
1279
+ <span class="normal"> </span><span class="symbol">/</span><span class="normal"> loop and under the Clutter thread lock</span>
1280
+ <span class="normal"> </span><span class="comment">//</span>
1852
1281
  <span class="normal"> </span><span class="function">clutter_label_set_text</span><span class="normal"> </span><span class="symbol">(</span><span class="function">CLUTTER_LABEL</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">closure</span><span class="symbol">-&gt;</span><span class="normal">label</span><span class="symbol">),</span>
1853
1282
  <span class="normal"> closure</span><span class="symbol">-&gt;</span><span class="normal">text</span><span class="symbol">);</span>
1854
1283
 
@@ -1858,9 +1287,9 @@ thread:
1858
1287
  <span class="normal"> </span><span class="keyword">return</span><span class="normal"> FALSE</span><span class="symbol">;</span>
1859
1288
  <span class="cbracket">}</span>
1860
1289
 
1861
- <span class="normal"> </span><span class="comment">/* within another thread */</span>
1290
+ <span class="normal"> </span><span class="comment">// within another thread //</span>
1862
1291
  <span class="normal"> closure </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_new0</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">SomeClosure</span><span class="symbol">,</span><span class="normal"> </span><span class="number">1</span><span class="symbol">);</span>
1863
- <span class="normal"> </span><span class="comment">/* always take a reference on GObject instances */</span>
1292
+ <span class="normal"> </span><span class="comment">// always take a reference on GObject instances //</span>
1864
1293
  <span class="normal"> closure</span><span class="symbol">-&gt;</span><span class="normal">label </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_object_ref</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">my_application</span><span class="symbol">-&gt;</span><span class="normal">label</span><span class="symbol">);</span>
1865
1294
  <span class="normal"> closure</span><span class="symbol">-&gt;</span><span class="normal">text </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_strdup</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">processed_text_to_update_the_label</span><span class="symbol">);</span>
1866
1295
 
@@ -1873,675 +1302,811 @@ thread:
1873
1302
  </table>
1874
1303
  </div>
1875
1304
 
1876
- <p>
1877
- </p>
1878
- <p>
1879
- Rename to: clutter_threads_add_idle
1880
- </p>
1881
- <div class="variablelist"><table border="0" class="variablelist">
1305
+ <p></p>
1306
+ <p>Rename to: clutter_threads_add_idle</p>
1307
+ <div class="refsect3">
1308
+ <a name="id-1.7.2.9.6.30.12"></a><h4>Parameters</h4>
1309
+ <div class="informaltable"><table width="100%" border="0">
1882
1310
  <colgroup>
1883
- <col align="left" valign="top">
1884
- <col>
1311
+ <col width="150px" class="parameters_name">
1312
+ <col class="parameters_description">
1313
+ <col width="200px" class="parameters_annotations">
1885
1314
  </colgroup>
1886
1315
  <tbody>
1887
1316
  <tr>
1888
- <td><p><span class="term"><em class="parameter"><code>priority</code></em> :</span></p></td>
1889
- <td>the priority of the timeout source. Typically this will be in the
1890
- range between <span class="type">G_PRIORITY_DEFAULT_IDLE</span> and <span class="type">G_PRIORITY_HIGH_IDLE</span>
1891
- </td>
1892
- </tr>
1893
- <tr>
1894
- <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
1895
- <td>function to call</td>
1317
+ <td class="parameter_name"><p>priority</p></td>
1318
+ <td class="parameter_description"><p>the priority of the timeout source. Typically this will be in the
1319
+ range between <span class="type">G_PRIORITY_DEFAULT_IDLE</span> and <span class="type">G_PRIORITY_HIGH_IDLE</span></p></td>
1320
+ <td class="parameter_annotations"> </td>
1896
1321
  </tr>
1897
1322
  <tr>
1898
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1899
- <td>data to pass to the function</td>
1323
+ <td class="parameter_name"><p>func</p></td>
1324
+ <td class="parameter_description"><p>function to call</p></td>
1325
+ <td class="parameter_annotations"> </td>
1900
1326
  </tr>
1901
1327
  <tr>
1902
- <td><p><span class="term"><em class="parameter"><code>notify</code></em> :</span></p></td>
1903
- <td>functio to call when the idle source is removed</td>
1328
+ <td class="parameter_name"><p>data</p></td>
1329
+ <td class="parameter_description"><p>data to pass to the function</p></td>
1330
+ <td class="parameter_annotations"> </td>
1904
1331
  </tr>
1905
1332
  <tr>
1906
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1907
- <td>the ID (greater than 0) of the event source.</td>
1333
+ <td class="parameter_name"><p>notify</p></td>
1334
+ <td class="parameter_description"><p>functio to call when the idle source is removed</p></td>
1335
+ <td class="parameter_annotations"> </td>
1908
1336
  </tr>
1909
1337
  </tbody>
1910
1338
  </table></div>
1339
+ </div>
1340
+ <div class="refsect3">
1341
+ <a name="id-1.7.2.9.6.30.13"></a><h4>Returns</h4>
1342
+ <p> the ID (greater than 0) of the event source.</p>
1343
+ <p></p>
1344
+ </div>
1911
1345
  <p class="since">Since 0.4</p>
1912
1346
  </div>
1913
1347
  <hr>
1914
1348
  <div class="refsect2">
1915
- <a name="clutter-threads-add-timeout"></a><h3>clutter_threads_add_timeout ()</h3>
1916
- <pre class="programlisting"><span class="returnvalue">guint</span> clutter_threads_add_timeout (<em class="parameter"><code><span class="type">guint</span> interval</code></em>,
1917
- <em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
1918
- <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
1919
- <p>
1920
- Simple wrapper around <a class="link" href="clutter-General.html#clutter-threads-add-timeout-full" title="clutter_threads_add_timeout_full ()"><code class="function">clutter_threads_add_timeout_full()</code></a>.
1921
- </p>
1922
- <div class="variablelist"><table border="0" class="variablelist">
1349
+ <a name="clutter-threads-add-timeout"></a><h3>clutter_threads_add_timeout ()</h3>
1350
+ <pre class="programlisting"><span class="returnvalue">guint</span>
1351
+ clutter_threads_add_timeout (<em class="parameter"><code><span class="type">guint</span> interval</code></em>,
1352
+ <em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
1353
+ <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
1354
+ <p>Simple wrapper around <a class="link" href="clutter-General.html#clutter-threads-add-timeout-full" title="clutter_threads_add_timeout_full ()"><code class="function">clutter_threads_add_timeout_full()</code></a>.</p>
1355
+ <div class="refsect3">
1356
+ <a name="id-1.7.2.9.6.31.5"></a><h4>Parameters</h4>
1357
+ <div class="informaltable"><table width="100%" border="0">
1923
1358
  <colgroup>
1924
- <col align="left" valign="top">
1925
- <col>
1359
+ <col width="150px" class="parameters_name">
1360
+ <col class="parameters_description">
1361
+ <col width="200px" class="parameters_annotations">
1926
1362
  </colgroup>
1927
1363
  <tbody>
1928
1364
  <tr>
1929
- <td><p><span class="term"><em class="parameter"><code>interval</code></em> :</span></p></td>
1930
- <td>the time between calls to the function, in milliseconds</td>
1931
- </tr>
1932
- <tr>
1933
- <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
1934
- <td>function to call</td>
1365
+ <td class="parameter_name"><p>interval</p></td>
1366
+ <td class="parameter_description"><p>the time between calls to the function, in milliseconds</p></td>
1367
+ <td class="parameter_annotations"> </td>
1935
1368
  </tr>
1936
1369
  <tr>
1937
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1938
- <td>data to pass to the function</td>
1370
+ <td class="parameter_name"><p>func</p></td>
1371
+ <td class="parameter_description"><p>function to call</p></td>
1372
+ <td class="parameter_annotations"> </td>
1939
1373
  </tr>
1940
1374
  <tr>
1941
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1942
- <td>the ID (greater than 0) of the event source.</td>
1375
+ <td class="parameter_name"><p>data</p></td>
1376
+ <td class="parameter_description"><p>data to pass to the function</p></td>
1377
+ <td class="parameter_annotations"> </td>
1943
1378
  </tr>
1944
1379
  </tbody>
1945
1380
  </table></div>
1381
+ </div>
1382
+ <div class="refsect3">
1383
+ <a name="id-1.7.2.9.6.31.6"></a><h4>Returns</h4>
1384
+ <p> the ID (greater than 0) of the event source.</p>
1385
+ <p></p>
1386
+ </div>
1946
1387
  <p class="since">Since 0.4</p>
1947
1388
  </div>
1948
1389
  <hr>
1949
1390
  <div class="refsect2">
1950
- <a name="clutter-threads-add-timeout-full"></a><h3>clutter_threads_add_timeout_full ()</h3>
1951
- <pre class="programlisting"><span class="returnvalue">guint</span> clutter_threads_add_timeout_full (<em class="parameter"><code><span class="type">gint</span> priority</code></em>,
1952
- <em class="parameter"><code><span class="type">guint</span> interval</code></em>,
1953
- <em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
1954
- <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
1955
- <em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);</pre>
1956
- <p>
1957
- Sets a function to be called at regular intervals holding the Clutter
1391
+ <a name="clutter-threads-add-timeout-full"></a><h3>clutter_threads_add_timeout_full ()</h3>
1392
+ <pre class="programlisting"><span class="returnvalue">guint</span>
1393
+ clutter_threads_add_timeout_full (<em class="parameter"><code><span class="type">gint</span> priority</code></em>,
1394
+ <em class="parameter"><code><span class="type">guint</span> interval</code></em>,
1395
+ <em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
1396
+ <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
1397
+ <em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);</pre>
1398
+ <p>Sets a function to be called at regular intervals holding the Clutter
1958
1399
  threads lock, with the given priority. The function is called repeatedly
1959
1400
  until it returns <code class="literal">FALSE</code>, at which point the timeout is automatically
1960
- removed and the function will not be called again. The <em class="parameter"><code>notify</code></em> function
1961
- is called when the timeout is removed.
1962
- </p>
1963
- <p>
1964
- The first call to the function will be at the end of the first <em class="parameter"><code>interval</code></em>.
1965
- </p>
1966
- <p>
1967
- It is important to note that, due to how the Clutter main loop is
1401
+ removed and the function will not be called again. The <em class="parameter"><code>notify</code></em>
1402
+ function
1403
+ is called when the timeout is removed.</p>
1404
+ <p>The first call to the function will be at the end of the first <em class="parameter"><code>interval</code></em>
1405
+ .</p>
1406
+ <p>It is important to note that, due to how the Clutter main loop is
1968
1407
  implemented, the timing will not be accurate and it will not try to
1969
- "keep up" with the interval.
1970
- </p>
1971
- <p>
1972
- See also <a class="link" href="clutter-General.html#clutter-threads-add-idle-full" title="clutter_threads_add_idle_full ()"><code class="function">clutter_threads_add_idle_full()</code></a>.
1973
- </p>
1974
- <p>
1975
- Rename to: clutter_threads_add_timeout
1976
- </p>
1977
- <div class="variablelist"><table border="0" class="variablelist">
1408
+ "keep up" with the interval.</p>
1409
+ <p>See also <a class="link" href="clutter-General.html#clutter-threads-add-idle-full" title="clutter_threads_add_idle_full ()"><code class="function">clutter_threads_add_idle_full()</code></a>.</p>
1410
+ <p>Rename to: clutter_threads_add_timeout</p>
1411
+ <div class="refsect3">
1412
+ <a name="id-1.7.2.9.6.32.9"></a><h4>Parameters</h4>
1413
+ <div class="informaltable"><table width="100%" border="0">
1978
1414
  <colgroup>
1979
- <col align="left" valign="top">
1980
- <col>
1415
+ <col width="150px" class="parameters_name">
1416
+ <col class="parameters_description">
1417
+ <col width="200px" class="parameters_annotations">
1981
1418
  </colgroup>
1982
1419
  <tbody>
1983
1420
  <tr>
1984
- <td><p><span class="term"><em class="parameter"><code>priority</code></em> :</span></p></td>
1985
- <td>the priority of the timeout source. Typically this will be in the
1986
- range between <span class="type">G_PRIORITY_DEFAULT</span> and <span class="type">G_PRIORITY_HIGH</span>.</td>
1987
- </tr>
1988
- <tr>
1989
- <td><p><span class="term"><em class="parameter"><code>interval</code></em> :</span></p></td>
1990
- <td>the time between calls to the function, in milliseconds</td>
1421
+ <td class="parameter_name"><p>priority</p></td>
1422
+ <td class="parameter_description"><p>the priority of the timeout source. Typically this will be in the
1423
+ range between <span class="type">G_PRIORITY_DEFAULT</span> and <span class="type">G_PRIORITY_HIGH</span>.</p></td>
1424
+ <td class="parameter_annotations"> </td>
1991
1425
  </tr>
1992
1426
  <tr>
1993
- <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
1994
- <td>function to call</td>
1427
+ <td class="parameter_name"><p>interval</p></td>
1428
+ <td class="parameter_description"><p>the time between calls to the function, in milliseconds</p></td>
1429
+ <td class="parameter_annotations"> </td>
1995
1430
  </tr>
1996
1431
  <tr>
1997
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1998
- <td>data to pass to the function</td>
1432
+ <td class="parameter_name"><p>func</p></td>
1433
+ <td class="parameter_description"><p>function to call</p></td>
1434
+ <td class="parameter_annotations"> </td>
1999
1435
  </tr>
2000
1436
  <tr>
2001
- <td><p><span class="term"><em class="parameter"><code>notify</code></em> :</span></p></td>
2002
- <td>function to call when the timeout source is removed</td>
1437
+ <td class="parameter_name"><p>data</p></td>
1438
+ <td class="parameter_description"><p>data to pass to the function</p></td>
1439
+ <td class="parameter_annotations"> </td>
2003
1440
  </tr>
2004
1441
  <tr>
2005
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2006
- <td>the ID (greater than 0) of the event source.</td>
1442
+ <td class="parameter_name"><p>notify</p></td>
1443
+ <td class="parameter_description"><p>function to call when the timeout source is removed</p></td>
1444
+ <td class="parameter_annotations"> </td>
2007
1445
  </tr>
2008
1446
  </tbody>
2009
1447
  </table></div>
1448
+ </div>
1449
+ <div class="refsect3">
1450
+ <a name="id-1.7.2.9.6.32.10"></a><h4>Returns</h4>
1451
+ <p> the ID (greater than 0) of the event source.</p>
1452
+ <p></p>
1453
+ </div>
2010
1454
  <p class="since">Since 0.4</p>
2011
1455
  </div>
2012
1456
  <hr>
2013
1457
  <div class="refsect2">
2014
- <a name="clutter-threads-add-frame-source"></a><h3>clutter_threads_add_frame_source ()</h3>
2015
- <pre class="programlisting"><span class="returnvalue">guint</span> clutter_threads_add_frame_source (<em class="parameter"><code><span class="type">guint</span> fps</code></em>,
2016
- <em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
2017
- <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
2018
- <div class="warning">
2019
- <h3 class="title">Warning</h3>
2020
- <p><code class="literal">clutter_threads_add_frame_source</code> is deprecated and should not be used in newly-written code. 1.6</p>
2021
- </div>
2022
- <p>
2023
- Simple wrapper around <a class="link" href="clutter-General.html#clutter-threads-add-frame-source-full" title="clutter_threads_add_frame_source_full ()"><code class="function">clutter_threads_add_frame_source_full()</code></a>.
2024
- </p>
2025
- <div class="variablelist"><table border="0" class="variablelist">
1458
+ <a name="clutter-threads-add-frame-source"></a><h3>clutter_threads_add_frame_source ()</h3>
1459
+ <pre class="programlisting"><span class="returnvalue">guint</span>
1460
+ clutter_threads_add_frame_source (<em class="parameter"><code><span class="type">guint</span> fps</code></em>,
1461
+ <em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
1462
+ <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
1463
+ <div class="warning"><p><code class="literal">clutter_threads_add_frame_source</code> has been deprecated since version 1.6 and should not be used in newly-written code.</p></div>
1464
+ <p>Simple wrapper around <a class="link" href="clutter-General.html#clutter-threads-add-frame-source-full" title="clutter_threads_add_frame_source_full ()"><code class="function">clutter_threads_add_frame_source_full()</code></a>.</p>
1465
+ <div class="refsect3">
1466
+ <a name="id-1.7.2.9.6.33.7"></a><h4>Parameters</h4>
1467
+ <div class="informaltable"><table width="100%" border="0">
2026
1468
  <colgroup>
2027
- <col align="left" valign="top">
2028
- <col>
1469
+ <col width="150px" class="parameters_name">
1470
+ <col class="parameters_description">
1471
+ <col width="200px" class="parameters_annotations">
2029
1472
  </colgroup>
2030
1473
  <tbody>
2031
1474
  <tr>
2032
- <td><p><span class="term"><em class="parameter"><code>fps</code></em> :</span></p></td>
2033
- <td>the number of times per second to call the function</td>
2034
- </tr>
2035
- <tr>
2036
- <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
2037
- <td>function to call</td>
1475
+ <td class="parameter_name"><p>fps</p></td>
1476
+ <td class="parameter_description"><p>the number of times per second to call the function</p></td>
1477
+ <td class="parameter_annotations"> </td>
2038
1478
  </tr>
2039
1479
  <tr>
2040
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
2041
- <td>data to pass to the function</td>
1480
+ <td class="parameter_name"><p>func</p></td>
1481
+ <td class="parameter_description"><p>function to call</p></td>
1482
+ <td class="parameter_annotations"> </td>
2042
1483
  </tr>
2043
1484
  <tr>
2044
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2045
- <td>the ID (greater than 0) of the event source.</td>
1485
+ <td class="parameter_name"><p>data</p></td>
1486
+ <td class="parameter_description"><p>data to pass to the function</p></td>
1487
+ <td class="parameter_annotations"> </td>
2046
1488
  </tr>
2047
1489
  </tbody>
2048
1490
  </table></div>
1491
+ </div>
1492
+ <div class="refsect3">
1493
+ <a name="id-1.7.2.9.6.33.8"></a><h4>Returns</h4>
1494
+ <p> the ID (greater than 0) of the event source.</p>
1495
+ <p></p>
1496
+ </div>
2049
1497
  <p class="since">Since 0.8</p>
2050
1498
  </div>
2051
1499
  <hr>
2052
1500
  <div class="refsect2">
2053
- <a name="clutter-threads-add-frame-source-full"></a><h3>clutter_threads_add_frame_source_full ()</h3>
2054
- <pre class="programlisting"><span class="returnvalue">guint</span> clutter_threads_add_frame_source_full
2055
- (<em class="parameter"><code><span class="type">gint</span> priority</code></em>,
2056
- <em class="parameter"><code><span class="type">guint</span> fps</code></em>,
2057
- <em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
2058
- <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
2059
- <em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);</pre>
2060
- <div class="warning">
2061
- <h3 class="title">Warning</h3>
2062
- <p><code class="literal">clutter_threads_add_frame_source_full</code> is deprecated and should not be used in newly-written code. 1.6</p>
2063
- </div>
2064
- <p>
2065
- Sets a function to be called at regular intervals holding the Clutter
1501
+ <a name="clutter-threads-add-frame-source-full"></a><h3>clutter_threads_add_frame_source_full ()</h3>
1502
+ <pre class="programlisting"><span class="returnvalue">guint</span>
1503
+ clutter_threads_add_frame_source_full (<em class="parameter"><code><span class="type">gint</span> priority</code></em>,
1504
+ <em class="parameter"><code><span class="type">guint</span> fps</code></em>,
1505
+ <em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
1506
+ <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
1507
+ <em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);</pre>
1508
+ <div class="warning"><p><code class="literal">clutter_threads_add_frame_source_full</code> has been deprecated since version 1.6 and should not be used in newly-written code.</p></div>
1509
+ <p>Sets a function to be called at regular intervals holding the Clutter
2066
1510
  threads lock, with the given priority. The function is called repeatedly
2067
1511
  until it returns <code class="literal">FALSE</code>, at which point the timeout is automatically
2068
- removed and the function will not be called again. The <em class="parameter"><code>notify</code></em> function
2069
- is called when the timeout is removed.
2070
- </p>
2071
- <p>
2072
- This function is similar to <a class="link" href="clutter-General.html#clutter-threads-add-timeout-full" title="clutter_threads_add_timeout_full ()"><code class="function">clutter_threads_add_timeout_full()</code></a>
1512
+ removed and the function will not be called again. The <em class="parameter"><code>notify</code></em>
1513
+ function
1514
+ is called when the timeout is removed.</p>
1515
+ <p>This function is similar to <a class="link" href="clutter-General.html#clutter-threads-add-timeout-full" title="clutter_threads_add_timeout_full ()"><code class="function">clutter_threads_add_timeout_full()</code></a>
2073
1516
  except that it will try to compensate for delays. For example, if
2074
- <em class="parameter"><code>func</code></em> takes half the interval time to execute then the function
1517
+ <em class="parameter"><code>func</code></em>
1518
+ takes half the interval time to execute then the function
2075
1519
  will be called again half the interval time after it finished. In
2076
- contrast <a class="link" href="clutter-General.html#clutter-threads-add-timeout-full" title="clutter_threads_add_timeout_full ()"><code class="function">clutter_threads_add_timeout_full()</code></a> would not fire until a
1520
+ contrast <a class="link" href="clutter-General.html#clutter-threads-add-timeout-full" title="clutter_threads_add_timeout_full ()"><code class="function">clutter_threads_add_timeout_full()</code></a> would not fire until a
2077
1521
  full interval after the function completes so the delay between
2078
- calls would be <em class="parameter"><code>interval</code></em> * 1.5. This function does not however try
1522
+ calls would be <em class="parameter"><code>interval</code></em>
1523
+ * 1.5. This function does not however try
2079
1524
  to invoke the function multiple times to catch up missing frames if
2080
- <em class="parameter"><code>func</code></em> takes more than <em class="parameter"><code>interval</code></em> ms to execute.
2081
- </p>
2082
- <p>
2083
- See also <a class="link" href="clutter-General.html#clutter-threads-add-idle-full" title="clutter_threads_add_idle_full ()"><code class="function">clutter_threads_add_idle_full()</code></a>.
2084
- </p>
2085
- <p>
2086
- Rename to: clutter_threads_add_frame_source
2087
- </p>
2088
- <div class="variablelist"><table border="0" class="variablelist">
1525
+ <em class="parameter"><code>func</code></em>
1526
+ takes more than <em class="parameter"><code>interval</code></em>
1527
+ ms to execute.</p>
1528
+ <p>See also <a class="link" href="clutter-General.html#clutter-threads-add-idle-full" title="clutter_threads_add_idle_full ()"><code class="function">clutter_threads_add_idle_full()</code></a>.</p>
1529
+ <p>Rename to: clutter_threads_add_frame_source</p>
1530
+ <div class="refsect3">
1531
+ <a name="id-1.7.2.9.6.34.10"></a><h4>Parameters</h4>
1532
+ <div class="informaltable"><table width="100%" border="0">
2089
1533
  <colgroup>
2090
- <col align="left" valign="top">
2091
- <col>
1534
+ <col width="150px" class="parameters_name">
1535
+ <col class="parameters_description">
1536
+ <col width="200px" class="parameters_annotations">
2092
1537
  </colgroup>
2093
1538
  <tbody>
2094
1539
  <tr>
2095
- <td><p><span class="term"><em class="parameter"><code>priority</code></em> :</span></p></td>
2096
- <td>the priority of the frame source. Typically this will be in the
2097
- range between <code class="literal">G_PRIORITY_DEFAULT</code> and <code class="literal">G_PRIORITY_HIGH</code>.</td>
2098
- </tr>
2099
- <tr>
2100
- <td><p><span class="term"><em class="parameter"><code>fps</code></em> :</span></p></td>
2101
- <td>the number of times per second to call the function</td>
1540
+ <td class="parameter_name"><p>priority</p></td>
1541
+ <td class="parameter_description"><p>the priority of the frame source. Typically this will be in the
1542
+ range between <code class="literal">G_PRIORITY_DEFAULT</code> and <code class="literal">G_PRIORITY_HIGH</code>.</p></td>
1543
+ <td class="parameter_annotations"> </td>
2102
1544
  </tr>
2103
1545
  <tr>
2104
- <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
2105
- <td>function to call</td>
1546
+ <td class="parameter_name"><p>fps</p></td>
1547
+ <td class="parameter_description"><p>the number of times per second to call the function</p></td>
1548
+ <td class="parameter_annotations"> </td>
2106
1549
  </tr>
2107
1550
  <tr>
2108
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
2109
- <td>data to pass to the function</td>
1551
+ <td class="parameter_name"><p>func</p></td>
1552
+ <td class="parameter_description"><p>function to call</p></td>
1553
+ <td class="parameter_annotations"> </td>
2110
1554
  </tr>
2111
1555
  <tr>
2112
- <td><p><span class="term"><em class="parameter"><code>notify</code></em> :</span></p></td>
2113
- <td>function to call when the timeout source is removed</td>
1556
+ <td class="parameter_name"><p>data</p></td>
1557
+ <td class="parameter_description"><p>data to pass to the function</p></td>
1558
+ <td class="parameter_annotations"> </td>
2114
1559
  </tr>
2115
1560
  <tr>
2116
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2117
- <td>the ID (greater than 0) of the event source.</td>
1561
+ <td class="parameter_name"><p>notify</p></td>
1562
+ <td class="parameter_description"><p>function to call when the timeout source is removed</p></td>
1563
+ <td class="parameter_annotations"> </td>
2118
1564
  </tr>
2119
1565
  </tbody>
2120
1566
  </table></div>
1567
+ </div>
1568
+ <div class="refsect3">
1569
+ <a name="id-1.7.2.9.6.34.11"></a><h4>Returns</h4>
1570
+ <p> the ID (greater than 0) of the event source.</p>
1571
+ <p></p>
1572
+ </div>
2121
1573
  <p class="since">Since 0.8</p>
2122
1574
  </div>
2123
1575
  <hr>
2124
1576
  <div class="refsect2">
2125
- <a name="clutter-threads-add-repaint-func"></a><h3>clutter_threads_add_repaint_func ()</h3>
2126
- <pre class="programlisting"><span class="returnvalue">guint</span> clutter_threads_add_repaint_func (<em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
2127
- <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
2128
- <em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);</pre>
2129
- <p>
2130
- Adds a function to be called whenever Clutter is processing a new
2131
- frame.
2132
- </p>
2133
- <p>
2134
- If the function returns <code class="literal">FALSE</code> it is automatically removed from the
2135
- list of repaint functions and will not be called again.
2136
- </p>
2137
- <p>
2138
- This function is guaranteed to be called from within the same thread
2139
- that called <a class="link" href="clutter-General.html#clutter-main" title="clutter_main ()"><code class="function">clutter_main()</code></a>, and while the Clutter lock is being held;
1577
+ <a name="clutter-threads-add-repaint-func"></a><h3>clutter_threads_add_repaint_func ()</h3>
1578
+ <pre class="programlisting"><span class="returnvalue">guint</span>
1579
+ clutter_threads_add_repaint_func (<em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
1580
+ <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
1581
+ <em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);</pre>
1582
+ <p>Adds a function to be called whenever Clutter is processing a new
1583
+ frame.</p>
1584
+ <p>If the function returns <code class="literal">FALSE</code> it is automatically removed from the
1585
+ list of repaint functions and will not be called again.</p>
1586
+ <p>This function is guaranteed to be called from within the same thread
1587
+ that called <a class="link" href="clutter-General.html#clutter-main" title="clutter_main ()"><code class="function">clutter_main()</code></a>, and while the Clutter lock is being held;
2140
1588
  the function will be called within the main loop, so it is imperative
2141
- that it does not block, otherwise the frame time budget may be lost.
2142
- </p>
2143
- <p>
2144
- A repaint function is useful to ensure that an update of the scenegraph
1589
+ that it does not block, otherwise the frame time budget may be lost.</p>
1590
+ <p>A repaint function is useful to ensure that an update of the scenegraph
2145
1591
  is performed before the scenegraph is repainted; for instance, uploading
2146
1592
  a frame from a video into a <a class="link" href="ClutterTexture.html" title="ClutterTexture"><span class="type">ClutterTexture</span></a>. By default, a repaint
2147
1593
  function added using this function will be invoked prior to the frame
2148
- being processed.
2149
- </p>
2150
- <p>
2151
- Adding a repaint function does not automatically ensure that a new
2152
- frame will be queued.
2153
- </p>
2154
- <p>
2155
- When the repaint function is removed (either because it returned <code class="literal">FALSE</code>
2156
- or because <a class="link" href="clutter-General.html#clutter-threads-remove-repaint-func" title="clutter_threads_remove_repaint_func ()"><code class="function">clutter_threads_remove_repaint_func()</code></a> has been called) the
2157
- <em class="parameter"><code>notify</code></em> function will be called, if any is set.
2158
- </p>
2159
- <p>
2160
- See also: <a class="link" href="clutter-General.html#clutter-threads-add-repaint-func-full" title="clutter_threads_add_repaint_func_full ()"><code class="function">clutter_threads_add_repaint_func_full()</code></a>
2161
- </p>
2162
- <div class="variablelist"><table border="0" class="variablelist">
1594
+ being processed.</p>
1595
+ <p>Adding a repaint function does not automatically ensure that a new
1596
+ frame will be queued.</p>
1597
+ <p>When the repaint function is removed (either because it returned <code class="literal">FALSE</code>
1598
+ or because <a class="link" href="clutter-General.html#clutter-threads-remove-repaint-func" title="clutter_threads_remove_repaint_func ()"><code class="function">clutter_threads_remove_repaint_func()</code></a> has been called) the
1599
+ <em class="parameter"><code>notify</code></em>
1600
+ function will be called, if any is set.</p>
1601
+ <p>See also: <a class="link" href="clutter-General.html#clutter-threads-add-repaint-func-full" title="clutter_threads_add_repaint_func_full ()"><code class="function">clutter_threads_add_repaint_func_full()</code></a></p>
1602
+ <div class="refsect3">
1603
+ <a name="id-1.7.2.9.6.35.11"></a><h4>Parameters</h4>
1604
+ <div class="informaltable"><table width="100%" border="0">
2163
1605
  <colgroup>
2164
- <col align="left" valign="top">
2165
- <col>
1606
+ <col width="150px" class="parameters_name">
1607
+ <col class="parameters_description">
1608
+ <col width="200px" class="parameters_annotations">
2166
1609
  </colgroup>
2167
1610
  <tbody>
2168
1611
  <tr>
2169
- <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
2170
- <td>the function to be called within the paint cycle</td>
2171
- </tr>
2172
- <tr>
2173
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
2174
- <td>data to be passed to the function, or <code class="literal">NULL</code>
2175
- </td>
1612
+ <td class="parameter_name"><p>func</p></td>
1613
+ <td class="parameter_description"><p>the function to be called within the paint cycle</p></td>
1614
+ <td class="parameter_annotations"> </td>
2176
1615
  </tr>
2177
1616
  <tr>
2178
- <td><p><span class="term"><em class="parameter"><code>notify</code></em> :</span></p></td>
2179
- <td>function to be called when removing the repaint
2180
- function, or <code class="literal">NULL</code>
2181
- </td>
1617
+ <td class="parameter_name"><p>data</p></td>
1618
+ <td class="parameter_description"><p>data to be passed to the function, or <code class="literal">NULL</code></p></td>
1619
+ <td class="parameter_annotations"> </td>
2182
1620
  </tr>
2183
1621
  <tr>
2184
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2185
- <td>the ID (greater than 0) of the repaint function. You
2186
- can use the returned integer to remove the repaint function by
2187
- calling <a class="link" href="clutter-General.html#clutter-threads-remove-repaint-func" title="clutter_threads_remove_repaint_func ()"><code class="function">clutter_threads_remove_repaint_func()</code></a>.</td>
1622
+ <td class="parameter_name"><p>notify</p></td>
1623
+ <td class="parameter_description"><p>function to be called when removing the repaint
1624
+ function, or <code class="literal">NULL</code></p></td>
1625
+ <td class="parameter_annotations"> </td>
2188
1626
  </tr>
2189
1627
  </tbody>
2190
1628
  </table></div>
2191
- <p class="since">Since 1.0</p>
2192
1629
  </div>
2193
- <hr>
2194
- <div class="refsect2">
2195
- <a name="ClutterRepaintFlags"></a><h3>enum ClutterRepaintFlags</h3>
2196
- <pre class="programlisting">typedef enum {
2197
- CLUTTER_REPAINT_FLAGS_PRE_PAINT = 1 &lt;&lt; 0,
2198
- CLUTTER_REPAINT_FLAGS_POST_PAINT = 1 &lt;&lt; 1,
2199
- CLUTTER_REPAINT_FLAGS_QUEUE_REDRAW_ON_ADD = 1 &lt;&lt; 2
2200
- } ClutterRepaintFlags;
2201
- </pre>
2202
- <p>
2203
- Flags to pass to <a class="link" href="clutter-General.html#clutter-threads-add-repaint-func-full" title="clutter_threads_add_repaint_func_full ()"><code class="function">clutter_threads_add_repaint_func_full()</code></a>.
2204
- </p>
2205
- <div class="variablelist"><table border="0" class="variablelist">
2206
- <colgroup>
2207
- <col align="left" valign="top">
2208
- <col>
2209
- </colgroup>
2210
- <tbody>
2211
- <tr>
2212
- <td><p><a name="CLUTTER-REPAINT-FLAGS-PRE-PAINT:CAPS"></a><span class="term"><code class="literal">CLUTTER_REPAINT_FLAGS_PRE_PAINT</code></span></p></td>
2213
- <td>Run the repaint function prior to
2214
- painting the stages
2215
- </td>
2216
- </tr>
2217
- <tr>
2218
- <td><p><a name="CLUTTER-REPAINT-FLAGS-POST-PAINT:CAPS"></a><span class="term"><code class="literal">CLUTTER_REPAINT_FLAGS_POST_PAINT</code></span></p></td>
2219
- <td>Run the repaint function after
2220
- painting the stages
2221
- </td>
2222
- </tr>
2223
- <tr>
2224
- <td><p><a name="CLUTTER-REPAINT-FLAGS-QUEUE-REDRAW-ON-ADD:CAPS"></a><span class="term"><code class="literal">CLUTTER_REPAINT_FLAGS_QUEUE_REDRAW_ON_ADD</code></span></p></td>
2225
- <td>Ensure that a new frame
2226
- is queued after adding the repaint function
2227
- </td>
2228
- </tr>
2229
- </tbody>
2230
- </table></div>
2231
- <p class="since">Since 1.10</p>
1630
+ <div class="refsect3">
1631
+ <a name="id-1.7.2.9.6.35.12"></a><h4>Returns</h4>
1632
+ <p> the ID (greater than 0) of the repaint function. You
1633
+ can use the returned integer to remove the repaint function by
1634
+ calling <a class="link" href="clutter-General.html#clutter-threads-remove-repaint-func" title="clutter_threads_remove_repaint_func ()"><code class="function">clutter_threads_remove_repaint_func()</code></a>.</p>
1635
+ <p></p>
1636
+ </div>
1637
+ <p class="since">Since 1.0</p>
2232
1638
  </div>
2233
1639
  <hr>
2234
1640
  <div class="refsect2">
2235
- <a name="clutter-threads-add-repaint-func-full"></a><h3>clutter_threads_add_repaint_func_full ()</h3>
2236
- <pre class="programlisting"><span class="returnvalue">guint</span> clutter_threads_add_repaint_func_full
2237
- (<em class="parameter"><code><a class="link" href="clutter-General.html#ClutterRepaintFlags" title="enum ClutterRepaintFlags"><span class="type">ClutterRepaintFlags</span></a> flags</code></em>,
2238
- <em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
2239
- <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
2240
- <em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);</pre>
2241
- <p>
2242
- Adds a function to be called whenever Clutter is processing a new
2243
- frame.
2244
- </p>
2245
- <p>
2246
- If the function returns <code class="literal">FALSE</code> it is automatically removed from the
2247
- list of repaint functions and will not be called again.
2248
- </p>
2249
- <p>
2250
- This function is guaranteed to be called from within the same thread
2251
- that called <a class="link" href="clutter-General.html#clutter-main" title="clutter_main ()"><code class="function">clutter_main()</code></a>, and while the Clutter lock is being held;
1641
+ <a name="clutter-threads-add-repaint-func-full"></a><h3>clutter_threads_add_repaint_func_full ()</h3>
1642
+ <pre class="programlisting"><span class="returnvalue">guint</span>
1643
+ clutter_threads_add_repaint_func_full (<em class="parameter"><code><a class="link" href="clutter-General.html#ClutterRepaintFlags" title="enum ClutterRepaintFlags"><span class="type">ClutterRepaintFlags</span></a> flags</code></em>,
1644
+ <em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
1645
+ <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
1646
+ <em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);</pre>
1647
+ <p>Adds a function to be called whenever Clutter is processing a new
1648
+ frame.</p>
1649
+ <p>If the function returns <code class="literal">FALSE</code> it is automatically removed from the
1650
+ list of repaint functions and will not be called again.</p>
1651
+ <p>This function is guaranteed to be called from within the same thread
1652
+ that called <a class="link" href="clutter-General.html#clutter-main" title="clutter_main ()"><code class="function">clutter_main()</code></a>, and while the Clutter lock is being held;
2252
1653
  the function will be called within the main loop, so it is imperative
2253
- that it does not block, otherwise the frame time budget may be lost.
2254
- </p>
2255
- <p>
2256
- A repaint function is useful to ensure that an update of the scenegraph
1654
+ that it does not block, otherwise the frame time budget may be lost.</p>
1655
+ <p>A repaint function is useful to ensure that an update of the scenegraph
2257
1656
  is performed before the scenegraph is repainted; for instance, uploading
2258
- a frame from a video into a <a class="link" href="ClutterTexture.html" title="ClutterTexture"><span class="type">ClutterTexture</span></a>. The <em class="parameter"><code>flags</code></em> passed to this
1657
+ a frame from a video into a <a class="link" href="ClutterTexture.html" title="ClutterTexture"><span class="type">ClutterTexture</span></a>. The <em class="parameter"><code>flags</code></em>
1658
+ passed to this
2259
1659
  function will determine the section of the frame processing that will
2260
- result in <em class="parameter"><code>func</code></em> being called.
2261
- </p>
2262
- <p>
2263
- Adding a repaint function does not automatically ensure that a new
2264
- frame will be queued.
2265
- </p>
2266
- <p>
2267
- When the repaint function is removed (either because it returned <code class="literal">FALSE</code>
2268
- or because <a class="link" href="clutter-General.html#clutter-threads-remove-repaint-func" title="clutter_threads_remove_repaint_func ()"><code class="function">clutter_threads_remove_repaint_func()</code></a> has been called) the
2269
- <em class="parameter"><code>notify</code></em> function will be called, if any is set.
2270
- </p>
2271
- <div class="variablelist"><table border="0" class="variablelist">
1660
+ result in <em class="parameter"><code>func</code></em>
1661
+ being called.</p>
1662
+ <p>Adding a repaint function does not automatically ensure that a new
1663
+ frame will be queued.</p>
1664
+ <p>When the repaint function is removed (either because it returned <code class="literal">FALSE</code>
1665
+ or because <a class="link" href="clutter-General.html#clutter-threads-remove-repaint-func" title="clutter_threads_remove_repaint_func ()"><code class="function">clutter_threads_remove_repaint_func()</code></a> has been called) the
1666
+ <em class="parameter"><code>notify</code></em>
1667
+ function will be called, if any is set.</p>
1668
+ <div class="refsect3">
1669
+ <a name="id-1.7.2.9.6.36.10"></a><h4>Parameters</h4>
1670
+ <div class="informaltable"><table width="100%" border="0">
2272
1671
  <colgroup>
2273
- <col align="left" valign="top">
2274
- <col>
1672
+ <col width="150px" class="parameters_name">
1673
+ <col class="parameters_description">
1674
+ <col width="200px" class="parameters_annotations">
2275
1675
  </colgroup>
2276
1676
  <tbody>
2277
1677
  <tr>
2278
- <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
2279
- <td>flags for the repaint function</td>
2280
- </tr>
2281
- <tr>
2282
- <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
2283
- <td>the function to be called within the paint cycle</td>
1678
+ <td class="parameter_name"><p>flags</p></td>
1679
+ <td class="parameter_description"><p>flags for the repaint function</p></td>
1680
+ <td class="parameter_annotations"> </td>
2284
1681
  </tr>
2285
1682
  <tr>
2286
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
2287
- <td>data to be passed to the function, or <code class="literal">NULL</code>
2288
- </td>
1683
+ <td class="parameter_name"><p>func</p></td>
1684
+ <td class="parameter_description"><p>the function to be called within the paint cycle</p></td>
1685
+ <td class="parameter_annotations"> </td>
2289
1686
  </tr>
2290
1687
  <tr>
2291
- <td><p><span class="term"><em class="parameter"><code>notify</code></em> :</span></p></td>
2292
- <td>function to be called when removing the repaint
2293
- function, or <code class="literal">NULL</code>
2294
- </td>
1688
+ <td class="parameter_name"><p>data</p></td>
1689
+ <td class="parameter_description"><p>data to be passed to the function, or <code class="literal">NULL</code></p></td>
1690
+ <td class="parameter_annotations"> </td>
2295
1691
  </tr>
2296
1692
  <tr>
2297
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2298
- <td>the ID (greater than 0) of the repaint function. You
2299
- can use the returned integer to remove the repaint function by
2300
- calling <a class="link" href="clutter-General.html#clutter-threads-remove-repaint-func" title="clutter_threads_remove_repaint_func ()"><code class="function">clutter_threads_remove_repaint_func()</code></a>.</td>
1693
+ <td class="parameter_name"><p>notify</p></td>
1694
+ <td class="parameter_description"><p>function to be called when removing the repaint
1695
+ function, or <code class="literal">NULL</code></p></td>
1696
+ <td class="parameter_annotations"> </td>
2301
1697
  </tr>
2302
1698
  </tbody>
2303
1699
  </table></div>
1700
+ </div>
1701
+ <div class="refsect3">
1702
+ <a name="id-1.7.2.9.6.36.11"></a><h4>Returns</h4>
1703
+ <p> the ID (greater than 0) of the repaint function. You
1704
+ can use the returned integer to remove the repaint function by
1705
+ calling <a class="link" href="clutter-General.html#clutter-threads-remove-repaint-func" title="clutter_threads_remove_repaint_func ()"><code class="function">clutter_threads_remove_repaint_func()</code></a>.</p>
1706
+ <p></p>
1707
+ </div>
2304
1708
  <p class="since">Since 1.10</p>
2305
1709
  </div>
2306
1710
  <hr>
2307
1711
  <div class="refsect2">
2308
- <a name="clutter-threads-remove-repaint-func"></a><h3>clutter_threads_remove_repaint_func ()</h3>
2309
- <pre class="programlisting"><span class="returnvalue">void</span> clutter_threads_remove_repaint_func (<em class="parameter"><code><span class="type">guint</span> handle_id</code></em>);</pre>
2310
- <p>
2311
- Removes the repaint function with <em class="parameter"><code>handle_id</code></em> as its id
2312
- </p>
2313
- <div class="variablelist"><table border="0" class="variablelist">
1712
+ <a name="clutter-threads-remove-repaint-func"></a><h3>clutter_threads_remove_repaint_func ()</h3>
1713
+ <pre class="programlisting"><span class="returnvalue">void</span>
1714
+ clutter_threads_remove_repaint_func (<em class="parameter"><code><span class="type">guint</span> handle_id</code></em>);</pre>
1715
+ <p>Removes the repaint function with <em class="parameter"><code>handle_id</code></em>
1716
+ as its id</p>
1717
+ <div class="refsect3">
1718
+ <a name="id-1.7.2.9.6.37.5"></a><h4>Parameters</h4>
1719
+ <div class="informaltable"><table width="100%" border="0">
2314
1720
  <colgroup>
2315
- <col align="left" valign="top">
2316
- <col>
1721
+ <col width="150px" class="parameters_name">
1722
+ <col class="parameters_description">
1723
+ <col width="200px" class="parameters_annotations">
2317
1724
  </colgroup>
2318
1725
  <tbody><tr>
2319
- <td><p><span class="term"><em class="parameter"><code>handle_id</code></em> :</span></p></td>
2320
- <td>an unsigned integer greater than zero</td>
1726
+ <td class="parameter_name"><p>handle_id</p></td>
1727
+ <td class="parameter_description"><p>an unsigned integer greater than zero</p></td>
1728
+ <td class="parameter_annotations"> </td>
2321
1729
  </tr></tbody>
2322
1730
  </table></div>
1731
+ </div>
2323
1732
  <p class="since">Since 1.0</p>
2324
1733
  </div>
2325
1734
  <hr>
2326
1735
  <div class="refsect2">
2327
- <a name="clutter-get-keyboard-grab"></a><h3>clutter_get_keyboard_grab ()</h3>
2328
- <pre class="programlisting"><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="returnvalue">ClutterActor</span></a> * clutter_get_keyboard_grab (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
2329
- <p>
2330
- Queries the current keyboard grab of clutter.
2331
- </p>
2332
- <div class="variablelist"><table border="0" class="variablelist">
2333
- <colgroup>
2334
- <col align="left" valign="top">
2335
- <col>
2336
- </colgroup>
2337
- <tbody><tr>
2338
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2339
- <td>the actor currently holding the keyboard grab, or NULL if there is no grab. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2340
- </td>
2341
- </tr></tbody>
2342
- </table></div>
1736
+ <a name="clutter-get-keyboard-grab"></a><h3>clutter_get_keyboard_grab ()</h3>
1737
+ <pre class="programlisting"><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="returnvalue">ClutterActor</span></a> *
1738
+ clutter_get_keyboard_grab (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1739
+ <p>Queries the current keyboard grab of clutter.</p>
1740
+ <div class="refsect3">
1741
+ <a name="id-1.7.2.9.6.38.5"></a><h4>Returns</h4>
1742
+ <p> the actor currently holding the keyboard grab, or NULL if there is no grab. </p>
1743
+ <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
1744
+ </div>
2343
1745
  <p class="since">Since 0.6</p>
2344
1746
  </div>
2345
1747
  <hr>
2346
1748
  <div class="refsect2">
2347
- <a name="clutter-get-pointer-grab"></a><h3>clutter_get_pointer_grab ()</h3>
2348
- <pre class="programlisting"><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="returnvalue">ClutterActor</span></a> * clutter_get_pointer_grab (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
2349
- <p>
2350
- Queries the current pointer grab of clutter.
2351
- </p>
2352
- <div class="variablelist"><table border="0" class="variablelist">
2353
- <colgroup>
2354
- <col align="left" valign="top">
2355
- <col>
2356
- </colgroup>
2357
- <tbody><tr>
2358
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2359
- <td>the actor currently holding the pointer grab, or NULL if there is no grab. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2360
- </td>
2361
- </tr></tbody>
2362
- </table></div>
1749
+ <a name="clutter-get-pointer-grab"></a><h3>clutter_get_pointer_grab ()</h3>
1750
+ <pre class="programlisting"><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="returnvalue">ClutterActor</span></a> *
1751
+ clutter_get_pointer_grab (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1752
+ <p>Queries the current pointer grab of clutter.</p>
1753
+ <div class="refsect3">
1754
+ <a name="id-1.7.2.9.6.39.5"></a><h4>Returns</h4>
1755
+ <p> the actor currently holding the pointer grab, or NULL if there is no grab. </p>
1756
+ <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
1757
+ </div>
2363
1758
  <p class="since">Since 0.6</p>
2364
1759
  </div>
2365
1760
  <hr>
2366
1761
  <div class="refsect2">
2367
- <a name="clutter-grab-keyboard"></a><h3>clutter_grab_keyboard ()</h3>
2368
- <pre class="programlisting"><span class="returnvalue">void</span> clutter_grab_keyboard (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>);</pre>
2369
- <p>
2370
- Grabs keyboard events, after the grab is done keyboard
2371
- events (<a class="link" href="ClutterActor.html#ClutterActor-key-press-event" title='The "key-press-event" signal'><span class="type">"key-press-event"</span></a> and <a class="link" href="ClutterActor.html#ClutterActor-key-release-event" title='The "key-release-event" signal'><span class="type">"key-release-event"</span></a>)
1762
+ <a name="clutter-grab-keyboard"></a><h3>clutter_grab_keyboard ()</h3>
1763
+ <pre class="programlisting"><span class="returnvalue">void</span>
1764
+ clutter_grab_keyboard (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>);</pre>
1765
+ <p>Grabs keyboard events, after the grab is done keyboard
1766
+ events (<a class="link" href="ClutterActor.html#ClutterActor-key-press-event" title="The “key-press-event” signal"><span class="type">“key-press-event”</span></a> and <a class="link" href="ClutterActor.html#ClutterActor-key-release-event" title="The “key-release-event” signal"><span class="type">“key-release-event”</span></a>)
2372
1767
  are delivered to this actor directly. The source set in the event will be
2373
1768
  the actor that would have received the event if the keyboard grab was not
2374
- in effect.
2375
- </p>
2376
- <p>
2377
- Like pointer grabs, keyboard grabs should only be used as a last
2378
- resource.
2379
- </p>
2380
- <p>
2381
- See also <a class="link" href="ClutterStage.html#clutter-stage-set-key-focus" title="clutter_stage_set_key_focus ()"><code class="function">clutter_stage_set_key_focus()</code></a> and <a class="link" href="ClutterActor.html#clutter-actor-grab-key-focus" title="clutter_actor_grab_key_focus ()"><code class="function">clutter_actor_grab_key_focus()</code></a>
2382
- to perform a "soft" key grab and assign key focus to a specific actor.
2383
- </p>
2384
- <div class="variablelist"><table border="0" class="variablelist">
1769
+ in effect.</p>
1770
+ <p>Like pointer grabs, keyboard grabs should only be used as a last
1771
+ resource.</p>
1772
+ <p>See also <a class="link" href="ClutterStage.html#clutter-stage-set-key-focus" title="clutter_stage_set_key_focus ()"><code class="function">clutter_stage_set_key_focus()</code></a> and <a class="link" href="ClutterActor.html#clutter-actor-grab-key-focus" title="clutter_actor_grab_key_focus ()"><code class="function">clutter_actor_grab_key_focus()</code></a>
1773
+ to perform a "soft" key grab and assign key focus to a specific actor.</p>
1774
+ <div class="refsect3">
1775
+ <a name="id-1.7.2.9.6.40.7"></a><h4>Parameters</h4>
1776
+ <div class="informaltable"><table width="100%" border="0">
2385
1777
  <colgroup>
2386
- <col align="left" valign="top">
2387
- <col>
1778
+ <col width="150px" class="parameters_name">
1779
+ <col class="parameters_description">
1780
+ <col width="200px" class="parameters_annotations">
2388
1781
  </colgroup>
2389
1782
  <tbody><tr>
2390
- <td><p><span class="term"><em class="parameter"><code>actor</code></em> :</span></p></td>
2391
- <td>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>
2392
- </td>
1783
+ <td class="parameter_name"><p>actor</p></td>
1784
+ <td class="parameter_description"><p>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a></p></td>
1785
+ <td class="parameter_annotations"> </td>
2393
1786
  </tr></tbody>
2394
1787
  </table></div>
1788
+ </div>
2395
1789
  <p class="since">Since 0.6</p>
2396
1790
  </div>
2397
1791
  <hr>
2398
1792
  <div class="refsect2">
2399
- <a name="clutter-grab-pointer"></a><h3>clutter_grab_pointer ()</h3>
2400
- <pre class="programlisting"><span class="returnvalue">void</span> clutter_grab_pointer (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>);</pre>
2401
- <p>
2402
- Grabs pointer events, after the grab is done all pointer related events
1793
+ <a name="clutter-grab-pointer"></a><h3>clutter_grab_pointer ()</h3>
1794
+ <pre class="programlisting"><span class="returnvalue">void</span>
1795
+ clutter_grab_pointer (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>);</pre>
1796
+ <p>Grabs pointer events, after the grab is done all pointer related events
2403
1797
  (press, motion, release, enter, leave and scroll) are delivered to this
2404
1798
  actor directly without passing through both capture and bubble phases of
2405
1799
  the event delivery chain. The source set in the event will be the actor
2406
- that would have received the event if the pointer grab was not in effect.
2407
- </p>
2408
- <p>
2409
- </p>
2410
- <div class="note">
2411
- <h3 class="title">Note</h3>
1800
+ that would have received the event if the pointer grab was not in effect.</p>
2412
1801
  <p>Grabs completely override the entire event delivery chain
2413
1802
  done by Clutter. Pointer grabs should only be used as a last resource;
2414
- using the <a class="link" href="ClutterActor.html#ClutterActor-captured-event" title='The "captured-event" signal'><span class="type">"captured-event"</span></a> signal should always be the
1803
+ using the <a class="link" href="ClutterActor.html#ClutterActor-captured-event" title="The “captured-event” signal"><span class="type">“captured-event”</span></a> signal should always be the
2415
1804
  preferred way to intercept event delivery to reactive actors.</p>
2416
- </div>
2417
- <p>
2418
- </p>
2419
- <p>
2420
- This function should rarely be used.
2421
- </p>
2422
- <p>
2423
- If a grab is required, you are strongly encouraged to use a specific
2424
- input device by calling <a class="link" href="ClutterInputDevice.html#clutter-input-device-grab" title="clutter_input_device_grab ()"><code class="function">clutter_input_device_grab()</code></a>.
2425
- </p>
2426
- <div class="variablelist"><table border="0" class="variablelist">
1805
+ <p>This function should rarely be used.</p>
1806
+ <p>If a grab is required, you are strongly encouraged to use a specific
1807
+ input device by calling <a class="link" href="ClutterInputDevice.html#clutter-input-device-grab" title="clutter_input_device_grab ()"><code class="function">clutter_input_device_grab()</code></a>.</p>
1808
+ <div class="refsect3">
1809
+ <a name="id-1.7.2.9.6.41.8"></a><h4>Parameters</h4>
1810
+ <div class="informaltable"><table width="100%" border="0">
2427
1811
  <colgroup>
2428
- <col align="left" valign="top">
2429
- <col>
1812
+ <col width="150px" class="parameters_name">
1813
+ <col class="parameters_description">
1814
+ <col width="200px" class="parameters_annotations">
2430
1815
  </colgroup>
2431
1816
  <tbody><tr>
2432
- <td><p><span class="term"><em class="parameter"><code>actor</code></em> :</span></p></td>
2433
- <td>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>
2434
- </td>
1817
+ <td class="parameter_name"><p>actor</p></td>
1818
+ <td class="parameter_description"><p>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a></p></td>
1819
+ <td class="parameter_annotations"> </td>
2435
1820
  </tr></tbody>
2436
1821
  </table></div>
1822
+ </div>
2437
1823
  <p class="since">Since 0.6</p>
2438
1824
  </div>
2439
1825
  <hr>
2440
1826
  <div class="refsect2">
2441
- <a name="clutter-ungrab-keyboard"></a><h3>clutter_ungrab_keyboard ()</h3>
2442
- <pre class="programlisting"><span class="returnvalue">void</span> clutter_ungrab_keyboard (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
2443
- <p>
2444
- Removes an existing grab of the keyboard.
2445
- </p>
1827
+ <a name="clutter-ungrab-keyboard"></a><h3>clutter_ungrab_keyboard ()</h3>
1828
+ <pre class="programlisting"><span class="returnvalue">void</span>
1829
+ clutter_ungrab_keyboard (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1830
+ <p>Removes an existing grab of the keyboard.</p>
2446
1831
  <p class="since">Since 0.6</p>
2447
1832
  </div>
2448
1833
  <hr>
2449
1834
  <div class="refsect2">
2450
- <a name="clutter-ungrab-pointer"></a><h3>clutter_ungrab_pointer ()</h3>
2451
- <pre class="programlisting"><span class="returnvalue">void</span> clutter_ungrab_pointer (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
2452
- <p>
2453
- Removes an existing grab of the pointer.
2454
- </p>
1835
+ <a name="clutter-ungrab-pointer"></a><h3>clutter_ungrab_pointer ()</h3>
1836
+ <pre class="programlisting"><span class="returnvalue">void</span>
1837
+ clutter_ungrab_pointer (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1838
+ <p>Removes an existing grab of the pointer.</p>
2455
1839
  <p class="since">Since 0.6</p>
2456
1840
  </div>
2457
1841
  <hr>
2458
1842
  <div class="refsect2">
2459
- <a name="clutter-grab-pointer-for-device"></a><h3>clutter_grab_pointer_for_device ()</h3>
2460
- <pre class="programlisting"><span class="returnvalue">void</span> clutter_grab_pointer_for_device (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>,
2461
- <em class="parameter"><code><span class="type">gint</span> id_</code></em>);</pre>
1843
+ <a name="clutter-grab-pointer-for-device"></a><h3>clutter_grab_pointer_for_device ()</h3>
1844
+ <pre class="programlisting"><span class="returnvalue">void</span>
1845
+ clutter_grab_pointer_for_device (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>,
1846
+ <em class="parameter"><code><span class="type">gint</span> id_</code></em>);</pre>
2462
1847
  <div class="warning">
2463
- <h3 class="title">Warning</h3>
2464
- <p><code class="literal">clutter_grab_pointer_for_device</code> has been deprecated since version 1.10 and should not be used in newly-written code. Use <a class="link" href="ClutterInputDevice.html#clutter-input-device-grab" title="clutter_input_device_grab ()"><code class="function">clutter_input_device_grab()</code></a> instead.</p>
2465
- </div>
2466
- <p>
2467
- Grabs all the pointer events coming from the device <em class="parameter"><code>id</code></em> for <em class="parameter"><code>actor</code></em>.
2468
- </p>
2469
- <p>
2470
- If <em class="parameter"><code>id</code></em> is -1 then this function is equivalent to <a class="link" href="clutter-General.html#clutter-grab-pointer" title="clutter_grab_pointer ()"><code class="function">clutter_grab_pointer()</code></a>.
2471
- </p>
2472
- <div class="variablelist"><table border="0" class="variablelist">
1848
+ <p><code class="literal">clutter_grab_pointer_for_device</code> has been deprecated since version 1.10 and should not be used in newly-written code.</p>
1849
+ <p>Use <a class="link" href="ClutterInputDevice.html#clutter-input-device-grab" title="clutter_input_device_grab ()"><code class="function">clutter_input_device_grab()</code></a> instead.</p>
1850
+ </div>
1851
+ <p>Grabs all the pointer events coming from the device <em class="parameter"><code>id</code></em>
1852
+ for <em class="parameter"><code>actor</code></em>
1853
+ .</p>
1854
+ <p>If <em class="parameter"><code>id</code></em>
1855
+ is -1 then this function is equivalent to <a class="link" href="clutter-General.html#clutter-grab-pointer" title="clutter_grab_pointer ()"><code class="function">clutter_grab_pointer()</code></a>.</p>
1856
+ <div class="refsect3">
1857
+ <a name="id-1.7.2.9.6.44.8"></a><h4>Parameters</h4>
1858
+ <div class="informaltable"><table width="100%" border="0">
2473
1859
  <colgroup>
2474
- <col align="left" valign="top">
2475
- <col>
1860
+ <col width="150px" class="parameters_name">
1861
+ <col class="parameters_description">
1862
+ <col width="200px" class="parameters_annotations">
2476
1863
  </colgroup>
2477
1864
  <tbody>
2478
1865
  <tr>
2479
- <td><p><span class="term"><em class="parameter"><code>actor</code></em> :</span></p></td>
2480
- <td>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>
2481
- </td>
1866
+ <td class="parameter_name"><p>actor</p></td>
1867
+ <td class="parameter_description"><p>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a></p></td>
1868
+ <td class="parameter_annotations"> </td>
2482
1869
  </tr>
2483
1870
  <tr>
2484
- <td><p><span class="term"><em class="parameter"><code>id_</code></em> :</span></p></td>
2485
- <td>a device id, or -1</td>
1871
+ <td class="parameter_name"><p>id_</p></td>
1872
+ <td class="parameter_description"><p>a device id, or -1</p></td>
1873
+ <td class="parameter_annotations"> </td>
2486
1874
  </tr>
2487
1875
  </tbody>
2488
1876
  </table></div>
1877
+ </div>
2489
1878
  <p class="since">Since 0.8</p>
2490
1879
  </div>
2491
1880
  <hr>
2492
1881
  <div class="refsect2">
2493
- <a name="clutter-ungrab-pointer-for-device"></a><h3>clutter_ungrab_pointer_for_device ()</h3>
2494
- <pre class="programlisting"><span class="returnvalue">void</span> clutter_ungrab_pointer_for_device (<em class="parameter"><code><span class="type">gint</span> id_</code></em>);</pre>
1882
+ <a name="clutter-ungrab-pointer-for-device"></a><h3>clutter_ungrab_pointer_for_device ()</h3>
1883
+ <pre class="programlisting"><span class="returnvalue">void</span>
1884
+ clutter_ungrab_pointer_for_device (<em class="parameter"><code><span class="type">gint</span> id_</code></em>);</pre>
2495
1885
  <div class="warning">
2496
- <h3 class="title">Warning</h3>
2497
- <p><code class="literal">clutter_ungrab_pointer_for_device</code> has been deprecated since version 1.10 and should not be used in newly-written code. Use <a class="link" href="ClutterInputDevice.html#clutter-input-device-ungrab" title="clutter_input_device_ungrab ()"><code class="function">clutter_input_device_ungrab()</code></a> instead.</p>
2498
- </div>
2499
- <p>
2500
- Removes an existing grab of the pointer events for device <em class="parameter"><code>id_</code></em>.
2501
- </p>
2502
- <div class="variablelist"><table border="0" class="variablelist">
1886
+ <p><code class="literal">clutter_ungrab_pointer_for_device</code> has been deprecated since version 1.10 and should not be used in newly-written code.</p>
1887
+ <p>Use <a class="link" href="ClutterInputDevice.html#clutter-input-device-ungrab" title="clutter_input_device_ungrab ()"><code class="function">clutter_input_device_ungrab()</code></a> instead.</p>
1888
+ </div>
1889
+ <p>Removes an existing grab of the pointer events for device <em class="parameter"><code>id_</code></em>
1890
+ .</p>
1891
+ <div class="refsect3">
1892
+ <a name="id-1.7.2.9.6.45.7"></a><h4>Parameters</h4>
1893
+ <div class="informaltable"><table width="100%" border="0">
2503
1894
  <colgroup>
2504
- <col align="left" valign="top">
2505
- <col>
1895
+ <col width="150px" class="parameters_name">
1896
+ <col class="parameters_description">
1897
+ <col width="200px" class="parameters_annotations">
2506
1898
  </colgroup>
2507
1899
  <tbody><tr>
2508
- <td><p><span class="term"><em class="parameter"><code>id_</code></em> :</span></p></td>
2509
- <td>a device id</td>
1900
+ <td class="parameter_name"><p>id_</p></td>
1901
+ <td class="parameter_description"><p>a device id</p></td>
1902
+ <td class="parameter_annotations"> </td>
2510
1903
  </tr></tbody>
2511
1904
  </table></div>
1905
+ </div>
2512
1906
  <p class="since">Since 0.8</p>
2513
1907
  </div>
2514
1908
  <hr>
2515
1909
  <div class="refsect2">
2516
- <a name="clutter-do-event"></a><h3>clutter_do_event ()</h3>
2517
- <pre class="programlisting"><span class="returnvalue">void</span> clutter_do_event (<em class="parameter"><code><a class="link" href="clutter-Events.html#ClutterEvent" title="union ClutterEvent"><span class="type">ClutterEvent</span></a> *event</code></em>);</pre>
2518
- <p>
2519
- Processes an event.
2520
- </p>
2521
- <p>
2522
- The <em class="parameter"><code>event</code></em> must be a valid <a class="link" href="clutter-Events.html#ClutterEvent" title="union ClutterEvent"><span class="type">ClutterEvent</span></a> and have a <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a>
2523
- associated to it.
2524
- </p>
2525
- <p>
2526
- This function is only useful when embedding Clutter inside another
2527
- toolkit, and it should never be called by applications.
2528
- </p>
2529
- <div class="variablelist"><table border="0" class="variablelist">
1910
+ <a name="clutter-do-event"></a><h3>clutter_do_event ()</h3>
1911
+ <pre class="programlisting"><span class="returnvalue">void</span>
1912
+ clutter_do_event (<em class="parameter"><code><a class="link" href="clutter-Events.html#ClutterEvent" title="union ClutterEvent"><span class="type">ClutterEvent</span></a> *event</code></em>);</pre>
1913
+ <p>Processes an event.</p>
1914
+ <p>The <em class="parameter"><code>event</code></em>
1915
+ must be a valid <a class="link" href="clutter-Events.html#ClutterEvent" title="union ClutterEvent"><span class="type">ClutterEvent</span></a> and have a <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a>
1916
+ associated to it.</p>
1917
+ <p>This function is only useful when embedding Clutter inside another
1918
+ toolkit, and it should never be called by applications.</p>
1919
+ <div class="refsect3">
1920
+ <a name="id-1.7.2.9.6.46.7"></a><h4>Parameters</h4>
1921
+ <div class="informaltable"><table width="100%" border="0">
2530
1922
  <colgroup>
2531
- <col align="left" valign="top">
2532
- <col>
1923
+ <col width="150px" class="parameters_name">
1924
+ <col class="parameters_description">
1925
+ <col width="200px" class="parameters_annotations">
2533
1926
  </colgroup>
2534
1927
  <tbody><tr>
2535
- <td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td>
2536
- <td>a <a class="link" href="clutter-Events.html#ClutterEvent" title="union ClutterEvent"><span class="type">ClutterEvent</span></a>.</td>
1928
+ <td class="parameter_name"><p>event</p></td>
1929
+ <td class="parameter_description"><p>a <a class="link" href="clutter-Events.html#ClutterEvent" title="union ClutterEvent"><span class="type">ClutterEvent</span></a>.</p></td>
1930
+ <td class="parameter_annotations"> </td>
2537
1931
  </tr></tbody>
2538
1932
  </table></div>
1933
+ </div>
2539
1934
  <p class="since">Since 0.4</p>
2540
1935
  </div>
2541
1936
  </div>
1937
+ <div class="refsect1">
1938
+ <a name="clutter-General.other_details"></a><h2>Types and Values</h2>
1939
+ <div class="refsect2">
1940
+ <a name="ClutterInitError"></a><h3>enum ClutterInitError</h3>
1941
+ <p>Error conditions returned by <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a> and <a class="link" href="clutter-General.html#clutter-init-with-args" title="clutter_init_with_args ()"><code class="function">clutter_init_with_args()</code></a>.</p>
1942
+ <div class="refsect3">
1943
+ <a name="id-1.7.2.9.7.2.4"></a><h4>Members</h4>
1944
+ <div class="informaltable"><table width="100%" border="0">
1945
+ <colgroup>
1946
+ <col width="300px" class="enum_members_name">
1947
+ <col class="enum_members_description">
1948
+ <col width="200px" class="enum_members_annotations">
1949
+ </colgroup>
1950
+ <tbody>
1951
+ <tr>
1952
+ <td class="enum_member_name"><p><a name="CLUTTER-INIT-SUCCESS:CAPS"></a>CLUTTER_INIT_SUCCESS</p></td>
1953
+ <td class="enum_member_description">
1954
+ <p>Initialisation successful</p>
1955
+ </td>
1956
+ <td class="enum_member_annotations"> </td>
1957
+ </tr>
1958
+ <tr>
1959
+ <td class="enum_member_name"><p><a name="CLUTTER-INIT-ERROR-UNKNOWN:CAPS"></a>CLUTTER_INIT_ERROR_UNKNOWN</p></td>
1960
+ <td class="enum_member_description">
1961
+ <p>Unknown error</p>
1962
+ </td>
1963
+ <td class="enum_member_annotations"> </td>
1964
+ </tr>
1965
+ <tr>
1966
+ <td class="enum_member_name"><p><a name="CLUTTER-INIT-ERROR-THREADS:CAPS"></a>CLUTTER_INIT_ERROR_THREADS</p></td>
1967
+ <td class="enum_member_description">
1968
+ <p>Thread initialisation failed</p>
1969
+ </td>
1970
+ <td class="enum_member_annotations"> </td>
1971
+ </tr>
1972
+ <tr>
1973
+ <td class="enum_member_name"><p><a name="CLUTTER-INIT-ERROR-BACKEND:CAPS"></a>CLUTTER_INIT_ERROR_BACKEND</p></td>
1974
+ <td class="enum_member_description">
1975
+ <p>Backend initialisation failed</p>
1976
+ </td>
1977
+ <td class="enum_member_annotations"> </td>
1978
+ </tr>
1979
+ <tr>
1980
+ <td class="enum_member_name"><p><a name="CLUTTER-INIT-ERROR-INTERNAL:CAPS"></a>CLUTTER_INIT_ERROR_INTERNAL</p></td>
1981
+ <td class="enum_member_description">
1982
+ <p>Internal error</p>
1983
+ </td>
1984
+ <td class="enum_member_annotations"> </td>
1985
+ </tr>
1986
+ </tbody>
1987
+ </table></div>
1988
+ </div>
1989
+ <p class="since">Since 0.2</p>
1990
+ </div>
1991
+ <hr>
1992
+ <div class="refsect2">
1993
+ <a name="ClutterFontFlags"></a><h3>enum ClutterFontFlags</h3>
1994
+ <p>Runtime flags to change the font quality. To be used with
1995
+ <a class="link" href="clutter-General.html#clutter-set-font-flags" title="clutter_set_font_flags ()"><code class="function">clutter_set_font_flags()</code></a>.</p>
1996
+ <div class="refsect3">
1997
+ <a name="id-1.7.2.9.7.3.4"></a><h4>Members</h4>
1998
+ <div class="informaltable"><table width="100%" border="0">
1999
+ <colgroup>
2000
+ <col width="300px" class="enum_members_name">
2001
+ <col class="enum_members_description">
2002
+ <col width="200px" class="enum_members_annotations">
2003
+ </colgroup>
2004
+ <tbody>
2005
+ <tr>
2006
+ <td class="enum_member_name"><p><a name="CLUTTER-FONT-MIPMAPPING:CAPS"></a>CLUTTER_FONT_MIPMAPPING</p></td>
2007
+ <td class="enum_member_description">
2008
+ <p>Set to use mipmaps for the glyph cache textures.</p>
2009
+ </td>
2010
+ <td class="enum_member_annotations"> </td>
2011
+ </tr>
2012
+ <tr>
2013
+ <td class="enum_member_name"><p><a name="CLUTTER-FONT-HINTING:CAPS"></a>CLUTTER_FONT_HINTING</p></td>
2014
+ <td class="enum_member_description">
2015
+ <p>Set to enable hinting on the glyphs.</p>
2016
+ </td>
2017
+ <td class="enum_member_annotations"> </td>
2018
+ </tr>
2019
+ </tbody>
2020
+ </table></div>
2021
+ </div>
2022
+ <p class="since">Since 1.0</p>
2023
+ </div>
2024
+ <hr>
2025
+ <div class="refsect2">
2026
+ <a name="ClutterTextDirection"></a><h3>enum ClutterTextDirection</h3>
2027
+ <p>The text direction to be used by <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>&lt;!-- --&gt;s</p>
2028
+ <div class="refsect3">
2029
+ <a name="id-1.7.2.9.7.4.4"></a><h4>Members</h4>
2030
+ <div class="informaltable"><table width="100%" border="0">
2031
+ <colgroup>
2032
+ <col width="300px" class="enum_members_name">
2033
+ <col class="enum_members_description">
2034
+ <col width="200px" class="enum_members_annotations">
2035
+ </colgroup>
2036
+ <tbody>
2037
+ <tr>
2038
+ <td class="enum_member_name"><p><a name="CLUTTER-TEXT-DIRECTION-DEFAULT:CAPS"></a>CLUTTER_TEXT_DIRECTION_DEFAULT</p></td>
2039
+ <td class="enum_member_description">
2040
+ <p>Use the default setting, as returned
2041
+ by <a class="link" href="clutter-General.html#clutter-get-default-text-direction" title="clutter_get_default_text_direction ()"><code class="function">clutter_get_default_text_direction()</code></a></p>
2042
+ </td>
2043
+ <td class="enum_member_annotations"> </td>
2044
+ </tr>
2045
+ <tr>
2046
+ <td class="enum_member_name"><p><a name="CLUTTER-TEXT-DIRECTION-LTR:CAPS"></a>CLUTTER_TEXT_DIRECTION_LTR</p></td>
2047
+ <td class="enum_member_description">
2048
+ <p>Use left-to-right text direction</p>
2049
+ </td>
2050
+ <td class="enum_member_annotations"> </td>
2051
+ </tr>
2052
+ <tr>
2053
+ <td class="enum_member_name"><p><a name="CLUTTER-TEXT-DIRECTION-RTL:CAPS"></a>CLUTTER_TEXT_DIRECTION_RTL</p></td>
2054
+ <td class="enum_member_description">
2055
+ <p>Use right-to-left text direction</p>
2056
+ </td>
2057
+ <td class="enum_member_annotations"> </td>
2058
+ </tr>
2059
+ </tbody>
2060
+ </table></div>
2061
+ </div>
2062
+ <p class="since">Since 1.2</p>
2063
+ </div>
2064
+ <hr>
2065
+ <div class="refsect2">
2066
+ <a name="ClutterRepaintFlags"></a><h3>enum ClutterRepaintFlags</h3>
2067
+ <p>Flags to pass to <a class="link" href="clutter-General.html#clutter-threads-add-repaint-func-full" title="clutter_threads_add_repaint_func_full ()"><code class="function">clutter_threads_add_repaint_func_full()</code></a>.</p>
2068
+ <div class="refsect3">
2069
+ <a name="id-1.7.2.9.7.5.4"></a><h4>Members</h4>
2070
+ <div class="informaltable"><table width="100%" border="0">
2071
+ <colgroup>
2072
+ <col width="300px" class="enum_members_name">
2073
+ <col class="enum_members_description">
2074
+ <col width="200px" class="enum_members_annotations">
2075
+ </colgroup>
2076
+ <tbody>
2077
+ <tr>
2078
+ <td class="enum_member_name"><p><a name="CLUTTER-REPAINT-FLAGS-PRE-PAINT:CAPS"></a>CLUTTER_REPAINT_FLAGS_PRE_PAINT</p></td>
2079
+ <td class="enum_member_description">
2080
+ <p>Run the repaint function prior to
2081
+ painting the stages</p>
2082
+ </td>
2083
+ <td class="enum_member_annotations"> </td>
2084
+ </tr>
2085
+ <tr>
2086
+ <td class="enum_member_name"><p><a name="CLUTTER-REPAINT-FLAGS-POST-PAINT:CAPS"></a>CLUTTER_REPAINT_FLAGS_POST_PAINT</p></td>
2087
+ <td class="enum_member_description">
2088
+ <p>Run the repaint function after
2089
+ painting the stages</p>
2090
+ </td>
2091
+ <td class="enum_member_annotations"> </td>
2092
+ </tr>
2093
+ <tr>
2094
+ <td class="enum_member_name"><p><a name="CLUTTER-REPAINT-FLAGS-QUEUE-REDRAW-ON-ADD:CAPS"></a>CLUTTER_REPAINT_FLAGS_QUEUE_REDRAW_ON_ADD</p></td>
2095
+ <td class="enum_member_description">
2096
+ <p>Ensure that a new frame
2097
+ is queued after adding the repaint function</p>
2098
+ </td>
2099
+ <td class="enum_member_annotations"> </td>
2100
+ </tr>
2101
+ </tbody>
2102
+ </table></div>
2103
+ </div>
2104
+ <p class="since">Since 1.10</p>
2105
+ </div>
2106
+ </div>
2542
2107
  </div>
2543
2108
  <div class="footer">
2544
2109
  <hr>
2545
- Generated by GTK-Doc V1.19.1</div>
2110
+ Generated by GTK-Doc V1.20.1</div>
2546
2111
  </body>
2547
2112
  </html>