clutter 2.0.0-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.
- data/Rakefile +129 -0
- data/lib/clutter.rb +145 -0
- data/lib/clutter/actor-iter.rb +33 -0
- data/lib/clutter/actor.rb +34 -0
- data/lib/clutter/animatable.rb +26 -0
- data/lib/clutter/cairo.rb +24 -0
- data/lib/clutter/color.rb +55 -0
- data/lib/clutter/event.rb +21 -0
- data/lib/clutter/point.rb +25 -0
- data/lib/clutter/text.rb +23 -0
- data/lib/clutter/threads.rb +38 -0
- data/sample/basic-actor.rb +125 -0
- data/sample/bin-layout.rb +215 -0
- data/sample/box-layout.rb +196 -0
- data/sample/canvas.rb +117 -0
- data/sample/constraints.rb +81 -0
- data/sample/drag-action.rb +177 -0
- data/sample/drop-action.rb +198 -0
- data/sample/easing-modes.rb +145 -0
- data/sample/flow-layout.rb +121 -0
- data/sample/grid-layout.rb +239 -0
- data/sample/image-content.rb +88 -0
- data/sample/pan-action.rb +100 -0
- data/sample/redhand.png +0 -0
- data/sample/rounded-rectangle.rb +90 -0
- data/sample/scroll-actor.rb +105 -0
- data/test/clutter-test-utils.rb +21 -0
- data/test/run-test.rb +50 -0
- data/vendor/local/bin/libclutter-1.0-0.dll +0 -0
- data/vendor/local/bin/libcogl-12.dll +0 -0
- data/vendor/local/bin/libcogl-pango-12.dll +0 -0
- data/vendor/local/bin/libglut-0.dll +0 -0
- data/vendor/local/bin/libjson-glib-1.0-0.dll +0 -0
- data/vendor/local/include/GL/freeglut.h +22 -0
- data/vendor/local/include/GL/freeglut_ext.h +239 -0
- data/vendor/local/include/GL/freeglut_std.h +636 -0
- data/vendor/local/include/GL/glut.h +21 -0
- data/vendor/local/include/clutter-1.0/cally/cally-actor.h +155 -0
- data/vendor/local/include/clutter-1.0/cally/cally-clone.h +82 -0
- data/vendor/local/include/clutter-1.0/cally/cally-factory.h +117 -0
- data/vendor/local/include/clutter-1.0/cally/cally-group.h +85 -0
- data/vendor/local/include/clutter-1.0/cally/cally-main.h +39 -0
- data/vendor/local/include/clutter-1.0/cally/cally-rectangle.h +82 -0
- data/vendor/local/include/clutter-1.0/cally/cally-root.h +82 -0
- data/vendor/local/include/clutter-1.0/cally/cally-stage.h +82 -0
- data/vendor/local/include/clutter-1.0/cally/cally-text.h +82 -0
- data/vendor/local/include/clutter-1.0/cally/cally-texture.h +82 -0
- data/vendor/local/include/clutter-1.0/cally/cally-util.h +80 -0
- data/vendor/local/include/clutter-1.0/cally/cally.h +40 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-action.h +103 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-actor-meta.h +113 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-actor.h +735 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-align-constraint.h +69 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-animatable.h +116 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-backend.h +74 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-bin-layout.h +84 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-bind-constraint.h +69 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-binding-pool.h +122 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-blur-effect.h +57 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-box-layout.h +159 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-brightness-contrast-effect.h +80 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-cairo.h +59 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-canvas.h +100 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-child-meta.h +120 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-click-action.h +114 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-clone.h +90 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-cogl-compat.h +52 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-color-static.h +79 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-color.h +175 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-colorize-effect.h +63 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-config.h +19 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-constraint.h +108 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-container.h +184 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-content.h +103 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-deform-effect.h +111 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-deprecated.h +43 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-desaturate-effect.h +61 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-device-manager.h +104 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-drag-action.h +142 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-drop-action.h +113 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-effect.h +120 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-enum-types.h +183 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-enums.h +1362 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-event.h +509 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-feature.h +40 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-fixed-layout.h +80 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-flow-layout.h +110 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-gesture-action.h +154 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-grid-layout.h +161 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-group.h +95 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-image.h +141 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-input-device.h +118 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-interval.h +141 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-keyframe-transition.h +120 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-keysyms.h +2304 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-layout-manager.h +215 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-layout-meta.h +101 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-list-model.h +88 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-macros.h +279 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-main.h +148 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-marshal.h +273 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-model.h +381 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-offscreen-effect.h +112 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-page-turn-effect.h +72 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-paint-node.h +102 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-paint-nodes.h +150 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-pan-action.h +147 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-path-constraint.h +66 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-path.h +155 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-property-transition.h +91 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-rotate-action.h +100 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-script.h +204 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-scriptable.h +107 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-scroll-actor.h +97 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-settings.h +25 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-shader-effect.h +114 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-shader-types.h +95 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-snap-constraint.h +73 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-stage-manager.h +81 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-stage.h +215 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-swipe-action.h +107 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-table-layout.h +157 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-tap-action.h +102 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-text-buffer.h +172 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-text.h +237 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-texture.h +128 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-timeline.h +201 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-transition-group.h +91 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-transition.h +132 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-types.h +715 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-units.h +166 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-version.h +302 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter-zoom-action.h +114 -0
- data/vendor/local/include/clutter-1.0/clutter/clutter.h +118 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-actor.h +161 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-alpha.h +144 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-animatable.h +47 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-animation.h +206 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-animator.h +186 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-backend.h +64 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-behaviour-depth.h +101 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-behaviour-ellipse.h +159 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-behaviour-opacity.h +115 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-behaviour-path.h +135 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-behaviour-rotate.h +119 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-behaviour-scale.h +107 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-behaviour.h +170 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-bin-layout.h +56 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-box.h +143 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-cairo-texture.h +139 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-container.h +93 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-fixed.h +97 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-frame-source.h +49 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-group.h +62 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-input-device.h +41 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-keysyms.h +2306 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-main.h +96 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-media.h +121 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-rectangle.h +117 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-score.h +144 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-shader.h +182 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-stage-manager.h +42 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-stage.h +102 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-state.h +187 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-texture.h +138 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-timeline.h +41 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-timeout-pool.h +69 -0
- data/vendor/local/include/clutter-1.0/clutter/deprecated/clutter-util.h +40 -0
- data/vendor/local/include/clutter-1.0/clutter/win32/clutter-win32.h +58 -0
- data/vendor/local/include/cogl/cogl-pango/cogl-pango.h +245 -0
- data/vendor/local/include/cogl/cogl/cogl-attribute-buffer.h +131 -0
- data/vendor/local/include/cogl/cogl/cogl-attribute.h +532 -0
- data/vendor/local/include/cogl/cogl/cogl-bitmap.h +314 -0
- data/vendor/local/include/cogl/cogl/cogl-buffer.h +309 -0
- data/vendor/local/include/cogl/cogl/cogl-clip-state.h +50 -0
- data/vendor/local/include/cogl/cogl/cogl-clutter.h +47 -0
- data/vendor/local/include/cogl/cogl/cogl-color.h +543 -0
- data/vendor/local/include/cogl/cogl/cogl-context.h +350 -0
- data/vendor/local/include/cogl/cogl/cogl-defines.h +50 -0
- data/vendor/local/include/cogl/cogl/cogl-deprecated.h +36 -0
- data/vendor/local/include/cogl/cogl/cogl-depth-state.h +264 -0
- data/vendor/local/include/cogl/cogl/cogl-display.h +192 -0
- data/vendor/local/include/cogl/cogl/cogl-enum-types.h +100 -0
- data/vendor/local/include/cogl/cogl/cogl-error.h +176 -0
- data/vendor/local/include/cogl/cogl/cogl-euler.h +251 -0
- data/vendor/local/include/cogl/cogl/cogl-fixed.h +804 -0
- data/vendor/local/include/cogl/cogl/cogl-frame-info.h +129 -0
- data/vendor/local/include/cogl/cogl/cogl-framebuffer.h +1829 -0
- data/vendor/local/include/cogl/cogl/cogl-gles2-types.h +474 -0
- data/vendor/local/include/cogl/cogl/cogl-gles2.h +374 -0
- data/vendor/local/include/cogl/cogl/cogl-glib-source.h +59 -0
- data/vendor/local/include/cogl/cogl/cogl-index-buffer.h +85 -0
- data/vendor/local/include/cogl/cogl/cogl-indices.h +145 -0
- data/vendor/local/include/cogl/cogl/cogl-material-compat.h +1276 -0
- data/vendor/local/include/cogl/cogl/cogl-matrix-stack.h +620 -0
- data/vendor/local/include/cogl/cogl/cogl-matrix.h +798 -0
- data/vendor/local/include/cogl/cogl/cogl-meta-texture.h +181 -0
- data/vendor/local/include/cogl/cogl/cogl-object.h +219 -0
- data/vendor/local/include/cogl/cogl/cogl-offscreen.h +117 -0
- data/vendor/local/include/cogl/cogl/cogl-onscreen-template.h +106 -0
- data/vendor/local/include/cogl/cogl/cogl-onscreen.h +741 -0
- data/vendor/local/include/cogl/cogl/cogl-output.h +242 -0
- data/vendor/local/include/cogl/cogl/cogl-pango.h +33 -0
- data/vendor/local/include/cogl/cogl/cogl-path-functions.h +430 -0
- data/vendor/local/include/cogl/cogl/cogl-path.h +102 -0
- data/vendor/local/include/cogl/cogl/cogl-pipeline-layer-state.h +613 -0
- data/vendor/local/include/cogl/cogl/cogl-pipeline-state.h +924 -0
- data/vendor/local/include/cogl/cogl/cogl-pipeline.h +173 -0
- data/vendor/local/include/cogl/cogl/cogl-pixel-buffer.h +114 -0
- data/vendor/local/include/cogl/cogl/cogl-poll.h +174 -0
- data/vendor/local/include/cogl/cogl/cogl-primitive-texture.h +98 -0
- data/vendor/local/include/cogl/cogl/cogl-primitive.h +866 -0
- data/vendor/local/include/cogl/cogl/cogl-primitives.h +190 -0
- data/vendor/local/include/cogl/cogl/cogl-quaternion.h +545 -0
- data/vendor/local/include/cogl/cogl/cogl-renderer.h +423 -0
- data/vendor/local/include/cogl/cogl/cogl-shader.h +654 -0
- data/vendor/local/include/cogl/cogl/cogl-snippet.h +786 -0
- data/vendor/local/include/cogl/cogl/cogl-sub-texture.h +122 -0
- data/vendor/local/include/cogl/cogl/cogl-swap-chain.h +51 -0
- data/vendor/local/include/cogl/cogl/cogl-texture-2d-gl.h +73 -0
- data/vendor/local/include/cogl/cogl/cogl-texture-2d-sliced.h +130 -0
- data/vendor/local/include/cogl/cogl/cogl-texture-2d.h +191 -0
- data/vendor/local/include/cogl/cogl/cogl-texture-3d.h +187 -0
- data/vendor/local/include/cogl/cogl/cogl-texture-rectangle.h +204 -0
- data/vendor/local/include/cogl/cogl/cogl-texture.h +611 -0
- data/vendor/local/include/cogl/cogl/cogl-types.h +912 -0
- data/vendor/local/include/cogl/cogl/cogl-vector.h +351 -0
- data/vendor/local/include/cogl/cogl/cogl-version.h +185 -0
- data/vendor/local/include/cogl/cogl/cogl-vertex-buffer.h +409 -0
- data/vendor/local/include/cogl/cogl/cogl-win32-renderer.h +99 -0
- data/vendor/local/include/cogl/cogl/cogl.h +151 -0
- data/vendor/local/include/cogl/cogl/cogl1-context.h +1169 -0
- data/vendor/local/include/cogl/cogl/cogl2-compatibility.h +55 -0
- data/vendor/local/include/cogl/cogl/cogl2-experimental.h +31 -0
- data/vendor/local/include/cogl/cogl/cogl2-path.h +506 -0
- data/vendor/local/include/cogl/cogl/gl-prototypes/cogl-core-functions.h +191 -0
- data/vendor/local/include/cogl/cogl/gl-prototypes/cogl-gles2-functions.h +36 -0
- data/vendor/local/include/cogl/cogl/gl-prototypes/cogl-glsl-functions.h +279 -0
- data/vendor/local/include/cogl/cogl/gl-prototypes/cogl-in-gles-core-functions.h +141 -0
- data/vendor/local/include/cogl/cogl/gl-prototypes/cogl-in-gles2-core-functions.h +179 -0
- data/vendor/local/include/json-glib-1.0/json-glib/json-builder.h +106 -0
- data/vendor/local/include/json-glib-1.0/json-glib/json-enum-types.h +36 -0
- data/vendor/local/include/json-glib-1.0/json-glib/json-generator.h +107 -0
- data/vendor/local/include/json-glib-1.0/json-glib/json-glib.h +46 -0
- data/vendor/local/include/json-glib-1.0/json-glib/json-gobject.h +182 -0
- data/vendor/local/include/json-glib-1.0/json-glib/json-gvariant.h +46 -0
- data/vendor/local/include/json-glib-1.0/json-glib/json-parser.h +173 -0
- data/vendor/local/include/json-glib-1.0/json-glib/json-path.h +97 -0
- data/vendor/local/include/json-glib-1.0/json-glib/json-reader.h +150 -0
- data/vendor/local/include/json-glib-1.0/json-glib/json-types.h +334 -0
- data/vendor/local/include/json-glib-1.0/json-glib/json-version.h +100 -0
- data/vendor/local/lib/girepository-1.0/Cally-1.0.typelib +0 -0
- data/vendor/local/lib/girepository-1.0/Clutter-1.0.typelib +0 -0
- data/vendor/local/lib/girepository-1.0/Cogl-1.0.typelib +0 -0
- data/vendor/local/lib/girepository-1.0/CoglPango-1.0.typelib +0 -0
- data/vendor/local/lib/girepository-1.0/Json-1.0.typelib +0 -0
- data/vendor/local/lib/libclutter-1.0.dll.a +0 -0
- data/vendor/local/lib/libclutter-1.0.la +41 -0
- data/vendor/local/lib/libcogl-pango.dll.a +0 -0
- data/vendor/local/lib/libcogl-pango.la +41 -0
- data/vendor/local/lib/libcogl.dll.a +0 -0
- data/vendor/local/lib/libcogl.la +41 -0
- data/vendor/local/lib/libglut.a +0 -0
- data/vendor/local/lib/libglut.dll.a +0 -0
- data/vendor/local/lib/libglut.la +41 -0
- data/vendor/local/lib/libjson-glib-1.0.dll.a +0 -0
- data/vendor/local/lib/libjson-glib-1.0.la +41 -0
- data/vendor/local/lib/pkgconfig/cally-1.0.pc +13 -0
- data/vendor/local/lib/pkgconfig/clutter-1.0.pc +24 -0
- data/vendor/local/lib/pkgconfig/clutter-win32-1.0.pc +24 -0
- data/vendor/local/lib/pkgconfig/cogl-1.0.pc +13 -0
- data/vendor/local/lib/pkgconfig/cogl-2.0-experimental.pc +13 -0
- data/vendor/local/lib/pkgconfig/cogl-gl-1.0.pc +13 -0
- data/vendor/local/lib/pkgconfig/cogl-pango-1.0.pc +13 -0
- data/vendor/local/lib/pkgconfig/cogl-pango-2.0-experimental.pc +13 -0
- data/vendor/local/lib/pkgconfig/json-glib-1.0.pc +11 -0
- data/vendor/local/share/cogl/examples-data/crate.jpg +0 -0
- data/vendor/local/share/gir-1.0/Cally-1.0.gir +679 -0
- data/vendor/local/share/gir-1.0/Clutter-1.0.gir +67473 -0
- data/vendor/local/share/gir-1.0/Cogl-1.0.gir +8383 -0
- data/vendor/local/share/gir-1.0/CoglPango-1.0.gir +306 -0
- data/vendor/local/share/gir-1.0/Json-1.0.gir +4333 -0
- data/vendor/local/share/gtk-doc/html/cally/CallyActor.html +415 -0
- data/vendor/local/share/gtk-doc/html/cally/CallyClone.html +136 -0
- data/vendor/local/share/gtk-doc/html/cally/CallyGroup.html +139 -0
- data/vendor/local/share/gtk-doc/html/cally/CallyRectangle.html +135 -0
- data/vendor/local/share/gtk-doc/html/cally/CallyRoot.html +123 -0
- data/vendor/local/share/gtk-doc/html/cally/CallyStage.html +140 -0
- data/vendor/local/share/gtk-doc/html/cally/CallyText.html +133 -0
- data/vendor/local/share/gtk-doc/html/cally/CallyTexture.html +135 -0
- data/vendor/local/share/gtk-doc/html/cally/CallyUtil.html +100 -0
- data/vendor/local/share/gtk-doc/html/cally/cally-General-API.html +167 -0
- data/vendor/local/share/gtk-doc/html/cally/cally.devhelp2 +73 -0
- data/vendor/local/share/gtk-doc/html/cally/callyannotationglossary.html +43 -0
- data/vendor/local/share/gtk-doc/html/cally/callybase.html +71 -0
- data/vendor/local/share/gtk-doc/html/cally/callyobjecthierarchy.html +45 -0
- data/vendor/local/share/gtk-doc/html/cally/callyobjectindex.html +64 -0
- data/vendor/local/share/gtk-doc/html/cally/callyobjects.html +39 -0
- data/vendor/local/share/gtk-doc/html/cally/ch01.html +53 -0
- data/vendor/local/share/gtk-doc/html/cally/ch02.html +41 -0
- data/vendor/local/share/gtk-doc/html/cally/clutter-overview.html +96 -0
- data/vendor/local/share/gtk-doc/html/cally/home.png +0 -0
- data/vendor/local/share/gtk-doc/html/cally/index.html +103 -0
- data/vendor/local/share/gtk-doc/html/cally/index.sgml +103 -0
- data/vendor/local/share/gtk-doc/html/cally/ix01.html +198 -0
- data/vendor/local/share/gtk-doc/html/cally/ix02.html +31 -0
- data/vendor/local/share/gtk-doc/html/cally/ix03.html +190 -0
- data/vendor/local/share/gtk-doc/html/cally/ix04.html +42 -0
- data/vendor/local/share/gtk-doc/html/cally/left.png +0 -0
- data/vendor/local/share/gtk-doc/html/cally/license.html +58 -0
- data/vendor/local/share/gtk-doc/html/cally/right.png +0 -0
- data/vendor/local/share/gtk-doc/html/cally/style.css +266 -0
- data/vendor/local/share/gtk-doc/html/cally/up.png +0 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterAction.html +110 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterActor.html +13714 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterActorMeta.html +322 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterAlignConstraint.html +404 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterAlpha.html +747 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterAnimatable.html +432 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterAnimator.html +1218 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterBackend.html +684 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterBehaviour.html +697 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterBehaviourDepth.html +278 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterBehaviourEllipse.html +844 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterBehaviourOpacity.html +283 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterBehaviourPath.html +450 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterBehaviourRotate.html +608 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterBehaviourScale.html +432 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterBinLayout.html +1056 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterBindConstraint.html +780 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterBlurEffect.html +109 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterBox.html +657 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterBoxLayout.html +1232 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterBrightnessContrastEffect.html +410 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterCairoTexture.html +1018 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterCanvas.html +469 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterChildMeta.html +253 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterClickAction.html +587 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterClone.html +219 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterColorizeEffect.html +193 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterConstraint.html +336 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterContainer.html +1346 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterContent.html +309 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterDeformEffect.html +353 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterDesaturateEffect.html +200 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterDeviceManager.html +408 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterDragAction.html +1224 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterDropAction.html +965 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterEffect.html +386 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterFixedLayout.html +115 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterFlowLayout.html +1016 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterGestureAction.html +867 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterGridLayout.html +808 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterGroup.html +231 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterImage.html +674 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterInputDevice.html +1488 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterKeyframeTransition.html +525 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterLayoutManager.html +1376 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterLayoutMeta.html +161 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterListModel.html +211 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterMedia.html +900 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterModel.html +1715 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterModelIter.html +644 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterOffscreenEffect.html +350 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterPageTurnEffect.html +333 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterPaintNode.html +534 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterPanAction.html +785 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterPath.html +1327 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterPathConstraint.html +321 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterPropertyTransition.html +216 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterRectangle.html +369 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterRotateAction.html +183 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterScore.html +881 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterScript.html +1365 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterScriptable.html +311 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterScrollActor.html +731 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterSettings.html +301 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterShaderEffect.html +595 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterSnapConstraint.html +421 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterStage.html +2252 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterState.html +1558 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterSwipeAction.html +280 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterTableLayout.html +1146 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterTapAction.html +192 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterText.html +3058 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterTextBuffer.html +736 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterTexture.html +1829 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterTimeline.html +2441 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterTransition.html +574 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterTransitionGroup.html +227 -0
- data/vendor/local/share/gtk-doc/html/clutter/ClutterZoomAction.html +400 -0
- data/vendor/local/share/gtk-doc/html/clutter/actor-box.png +0 -0
- data/vendor/local/share/gtk-doc/html/clutter/actor-example.png +0 -0
- data/vendor/local/share/gtk-doc/html/clutter/animator-key-frames.png +0 -0
- data/vendor/local/share/gtk-doc/html/clutter/annotation-glossary.html +111 -0
- data/vendor/local/share/gtk-doc/html/clutter/bin-layout.png +0 -0
- data/vendor/local/share/gtk-doc/html/clutter/box-layout.png +0 -0
- data/vendor/local/share/gtk-doc/html/clutter/building-clutter.html +275 -0
- data/vendor/local/share/gtk-doc/html/clutter/ch01.html +65 -0
- data/vendor/local/share/gtk-doc/html/clutter/ch02.html +47 -0
- data/vendor/local/share/gtk-doc/html/clutter/ch03.html +51 -0
- data/vendor/local/share/gtk-doc/html/clutter/ch04.html +59 -0
- data/vendor/local/share/gtk-doc/html/clutter/ch05.html +44 -0
- data/vendor/local/share/gtk-doc/html/clutter/ch06.html +57 -0
- data/vendor/local/share/gtk-doc/html/clutter/ch07.html +38 -0
- data/vendor/local/share/gtk-doc/html/clutter/ch08.html +38 -0
- data/vendor/local/share/gtk-doc/html/clutter/ch09.html +53 -0
- data/vendor/local/share/gtk-doc/html/clutter/ch10.html +78 -0
- data/vendor/local/share/gtk-doc/html/clutter/ch11.html +38 -0
- data/vendor/local/share/gtk-doc/html/clutter/ch12.html +41 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-Base-geometric-types.html +3471 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-ClutterGLXTexturePixmap.html +225 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-ClutterWaylandSurface.html +314 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-ClutterX11TexturePixmap.html +361 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-Colors.html +1363 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-EGL-Specific-Support.html +129 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-Events.html +2653 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-Features.html +200 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-GDK-Specific-Support.html +249 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-General.html +2550 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-Implicit-Animations.html +2571 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-Intel-CE3100-CE4100-Specific-Support.html +181 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-Key-Bindings.html +890 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-Paint-Nodes.html +351 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-Shaders.html +1004 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-Stage-Manager.html +341 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-Unit-conversion.html +843 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-Utilities.html +549 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-Value-intervals.html +1023 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-Versioning-Macros.html +525 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-Wayland-compositor-specific-support.html +83 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-Win32-Specific-Support.html +201 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-X11-Specific-Support.html +806 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter-overview.html +77 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutter.devhelp2 +2715 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutteranimation.html +65 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutterbackends.html +71 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutterbase.html +202 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutterglossary.html +37 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutterobjecthierarchy.html +118 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutterobjectindex.html +184 -0
- data/vendor/local/share/gtk-doc/html/clutter/clutterobjects.html +37 -0
- data/vendor/local/share/gtk-doc/html/clutter/cluttertools.html +105 -0
- data/vendor/local/share/gtk-doc/html/clutter/constraints-example.png +0 -0
- data/vendor/local/share/gtk-doc/html/clutter/deprecated.html +86 -0
- data/vendor/local/share/gtk-doc/html/clutter/easing-modes.png +0 -0
- data/vendor/local/share/gtk-doc/html/clutter/event-flow.png +0 -0
- data/vendor/local/share/gtk-doc/html/clutter/flow-layout.png +0 -0
- data/vendor/local/share/gtk-doc/html/clutter/go01.html +114 -0
- data/vendor/local/share/gtk-doc/html/clutter/home.png +0 -0
- data/vendor/local/share/gtk-doc/html/clutter/index.html +451 -0
- data/vendor/local/share/gtk-doc/html/clutter/index.sgml +3272 -0
- data/vendor/local/share/gtk-doc/html/clutter/iterating-paths.html +56 -0
- data/vendor/local/share/gtk-doc/html/clutter/ix01.html +8815 -0
- data/vendor/local/share/gtk-doc/html/clutter/ix02.html +1961 -0
- data/vendor/local/share/gtk-doc/html/clutter/ix03.html +454 -0
- data/vendor/local/share/gtk-doc/html/clutter/ix04.html +583 -0
- data/vendor/local/share/gtk-doc/html/clutter/ix05.html +957 -0
- data/vendor/local/share/gtk-doc/html/clutter/ix06.html +642 -0
- data/vendor/local/share/gtk-doc/html/clutter/ix07.html +1530 -0
- data/vendor/local/share/gtk-doc/html/clutter/ix08.html +820 -0
- data/vendor/local/share/gtk-doc/html/clutter/ix09.html +1005 -0
- data/vendor/local/share/gtk-doc/html/clutter/ix10.html +369 -0
- data/vendor/local/share/gtk-doc/html/clutter/ix11.html +366 -0
- data/vendor/local/share/gtk-doc/html/clutter/ix12.html +1078 -0
- data/vendor/local/share/gtk-doc/html/clutter/ix13.html +984 -0
- data/vendor/local/share/gtk-doc/html/clutter/ix14.html +99 -0
- data/vendor/local/share/gtk-doc/html/clutter/left.png +0 -0
- data/vendor/local/share/gtk-doc/html/clutter/license.html +58 -0
- data/vendor/local/share/gtk-doc/html/clutter/migrating-ClutterAnimation.html +223 -0
- data/vendor/local/share/gtk-doc/html/clutter/migrating-ClutterBehaviour.html +197 -0
- data/vendor/local/share/gtk-doc/html/clutter/migrating-ClutterEffect.html +154 -0
- data/vendor/local/share/gtk-doc/html/clutter/migrating-ClutterPath.html +156 -0
- data/vendor/local/share/gtk-doc/html/clutter/migration.html +49 -0
- data/vendor/local/share/gtk-doc/html/clutter/offscreen-redirect.png +0 -0
- data/vendor/local/share/gtk-doc/html/clutter/path-alpha-func.png +0 -0
- data/vendor/local/share/gtk-doc/html/clutter/pt09.html +31 -0
- data/vendor/local/share/gtk-doc/html/clutter/right.png +0 -0
- data/vendor/local/share/gtk-doc/html/clutter/running-clutter.html +373 -0
- data/vendor/local/share/gtk-doc/html/clutter/style.css +266 -0
- data/vendor/local/share/gtk-doc/html/clutter/table-layout.png +0 -0
- data/vendor/local/share/gtk-doc/html/clutter/up.png +0 -0
- data/vendor/local/share/gtk-doc/html/clutter/using-cairo.html +36 -0
- data/vendor/local/share/gtk-doc/html/json-glib/JsonBuilder.html +513 -0
- data/vendor/local/share/gtk-doc/html/json-glib/JsonGenerator.html +492 -0
- data/vendor/local/share/gtk-doc/html/json-glib/JsonParser.html +871 -0
- data/vendor/local/share/gtk-doc/html/json-glib/JsonPath.html +464 -0
- data/vendor/local/share/gtk-doc/html/json-glib/JsonReader.html +898 -0
- data/vendor/local/share/gtk-doc/html/json-glib/annotation-glossary.html +87 -0
- data/vendor/local/share/gtk-doc/html/json-glib/ch01.html +41 -0
- data/vendor/local/share/gtk-doc/html/json-glib/ch02.html +41 -0
- data/vendor/local/share/gtk-doc/html/json-glib/ch03.html +38 -0
- data/vendor/local/share/gtk-doc/html/json-glib/ch04.html +38 -0
- data/vendor/local/share/gtk-doc/html/json-glib/home.png +0 -0
- data/vendor/local/share/gtk-doc/html/json-glib/index.html +125 -0
- data/vendor/local/share/gtk-doc/html/json-glib/index.sgml +308 -0
- data/vendor/local/share/gtk-doc/html/json-glib/ix01.html +926 -0
- data/vendor/local/share/gtk-doc/html/json-glib/ix02.html +54 -0
- data/vendor/local/share/gtk-doc/html/json-glib/ix03.html +61 -0
- data/vendor/local/share/gtk-doc/html/json-glib/ix04.html +54 -0
- data/vendor/local/share/gtk-doc/html/json-glib/ix05.html +186 -0
- data/vendor/local/share/gtk-doc/html/json-glib/ix06.html +121 -0
- data/vendor/local/share/gtk-doc/html/json-glib/ix07.html +161 -0
- data/vendor/local/share/gtk-doc/html/json-glib/ix08.html +137 -0
- data/vendor/local/share/gtk-doc/html/json-glib/json-advanced.html +47 -0
- data/vendor/local/share/gtk-doc/html/json-glib/json-base.html +61 -0
- data/vendor/local/share/gtk-doc/html/json-glib/json-glib-Boxed-Types-Serialization.html +382 -0
- data/vendor/local/share/gtk-doc/html/json-glib/json-glib-GObject-Serialization.html +310 -0
- data/vendor/local/share/gtk-doc/html/json-glib/json-glib-JSON-Array.html +850 -0
- data/vendor/local/share/gtk-doc/html/json-glib/json-glib-JSON-GVariant-Integration.html +272 -0
- data/vendor/local/share/gtk-doc/html/json-glib/json-glib-JSON-Node.html +942 -0
- data/vendor/local/share/gtk-doc/html/json-glib/json-glib-JSON-Object.html +993 -0
- data/vendor/local/share/gtk-doc/html/json-glib/json-glib-Serializable-Interface.html +476 -0
- data/vendor/local/share/gtk-doc/html/json-glib/json-glib-Versioning-information.html +148 -0
- data/vendor/local/share/gtk-doc/html/json-glib/json-glib.devhelp2 +281 -0
- data/vendor/local/share/gtk-doc/html/json-glib/json-glib.html +38 -0
- data/vendor/local/share/gtk-doc/html/json-glib/json-streams.html +63 -0
- data/vendor/local/share/gtk-doc/html/json-glib/json-tools.html +39 -0
- data/vendor/local/share/gtk-doc/html/json-glib/left.png +0 -0
- data/vendor/local/share/gtk-doc/html/json-glib/license.html +58 -0
- data/vendor/local/share/gtk-doc/html/json-glib/right.png +0 -0
- data/vendor/local/share/gtk-doc/html/json-glib/style.css +266 -0
- data/vendor/local/share/gtk-doc/html/json-glib/up.png +0 -0
- data/vendor/local/share/license/clutter/COPYING +502 -0
- data/vendor/local/share/license/cogl/COPYING +502 -0
- data/vendor/local/share/license/freeglut/AUTHORS +39 -0
- data/vendor/local/share/license/freeglut/COPYING +27 -0
- data/vendor/local/share/license/json-glib/COPYING +504 -0
- data/vendor/local/share/locale/an/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/ar/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/ar/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/as/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/as/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/ast/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/ast/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/az_IR/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/be/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/be/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/bg/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/bg/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/ca/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/ca/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/cs/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/cs/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/cs/LC_MESSAGES/json-glib-1.0.mo +0 -0
- data/vendor/local/share/locale/da/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/da/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/de/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/de/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/de/LC_MESSAGES/json-glib-1.0.mo +0 -0
- data/vendor/local/share/locale/el/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/el/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/el/LC_MESSAGES/json-glib-1.0.mo +0 -0
- data/vendor/local/share/locale/en_CA/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/en_GB/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/en_GB/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/eo/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/eo/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/es/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/es/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/es/LC_MESSAGES/json-glib-1.0.mo +0 -0
- data/vendor/local/share/locale/eu/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/fa/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/fa/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/fi/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/fr/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/fr/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/gl/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/gl/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/gl/LC_MESSAGES/json-glib-1.0.mo +0 -0
- data/vendor/local/share/locale/he/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/he/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/hi/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/hi/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/hu/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/id/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/id/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/id/LC_MESSAGES/json-glib-1.0.mo +0 -0
- data/vendor/local/share/locale/it/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/it/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/it/LC_MESSAGES/json-glib-1.0.mo +0 -0
- data/vendor/local/share/locale/ja/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/ja/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/km/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/km/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/kn/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/kn/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/ko/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/lt/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/lt/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/lv/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/lv/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/mk/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/ml/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/ml/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/nb/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/nb/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/nb/LC_MESSAGES/json-glib-1.0.mo +0 -0
- data/vendor/local/share/locale/nl/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/nl/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/or/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/or/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/pa/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/pa/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/pa/LC_MESSAGES/json-glib-1.0.mo +0 -0
- data/vendor/local/share/locale/pl/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/pl/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/pl/LC_MESSAGES/json-glib-1.0.mo +0 -0
- data/vendor/local/share/locale/ps/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/pt/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/pt/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/pt_BR/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/pt_BR/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/pt_BR/LC_MESSAGES/json-glib-1.0.mo +0 -0
- data/vendor/local/share/locale/ro/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/ru/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/ru/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/ru/LC_MESSAGES/json-glib-1.0.mo +0 -0
- data/vendor/local/share/locale/sk/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/sk/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/sl/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/sl/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/sl/LC_MESSAGES/json-glib-1.0.mo +0 -0
- data/vendor/local/share/locale/sr/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/sr/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/sr@latin/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/sr@latin/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/sv/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/sv/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/sv/LC_MESSAGES/json-glib-1.0.mo +0 -0
- data/vendor/local/share/locale/ta/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/ta/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/te/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/te/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/tg/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/th/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/tr/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/tr/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/tr/LC_MESSAGES/json-glib-1.0.mo +0 -0
- data/vendor/local/share/locale/ug/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/ug/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/uk/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/uk/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/ur/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/vi/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/vi/LC_MESSAGES/json-glib-1.0.mo +0 -0
- data/vendor/local/share/locale/yi/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/zh_CN/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/zh_CN/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/zh_HK/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/zh_HK/LC_MESSAGES/cogl.mo +0 -0
- data/vendor/local/share/locale/zh_TW/LC_MESSAGES/clutter-1.0.mo +0 -0
- data/vendor/local/share/locale/zh_TW/LC_MESSAGES/cogl.mo +0 -0
- metadata +747 -0
@@ -0,0 +1,200 @@
|
|
1
|
+
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
2
|
+
<html>
|
3
|
+
<head>
|
4
|
+
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
5
|
+
<title>Features</title>
|
6
|
+
<meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
|
7
|
+
<link rel="home" href="index.html" title="Clutter Reference Manual">
|
8
|
+
<link rel="up" href="ch10.html" title="General purpose API">
|
9
|
+
<link rel="prev" href="clutter-Events.html" title="Events">
|
10
|
+
<link rel="next" href="clutter-Base-geometric-types.html" title="Base geometric types">
|
11
|
+
<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
|
12
|
+
<link rel="stylesheet" href="style.css" type="text/css">
|
13
|
+
</head>
|
14
|
+
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
15
|
+
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
|
16
|
+
<tr valign="middle">
|
17
|
+
<td><a accesskey="p" href="clutter-Events.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
|
18
|
+
<td><a accesskey="u" href="ch10.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
|
19
|
+
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
|
20
|
+
<th width="100%" align="center">Clutter Reference Manual</th>
|
21
|
+
<td><a accesskey="n" href="clutter-Base-geometric-types.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
|
22
|
+
</tr>
|
23
|
+
<tr><td colspan="5" class="shortcuts">
|
24
|
+
<a href="#clutter-Features.synopsis" class="shortcut">Top</a>
|
25
|
+
|
|
26
|
+
<a href="#clutter-Features.description" class="shortcut">Description</a>
|
27
|
+
</td></tr>
|
28
|
+
</table>
|
29
|
+
<div class="refentry">
|
30
|
+
<a name="clutter-Features"></a><div class="titlepage"></div>
|
31
|
+
<div class="refnamediv"><table width="100%"><tr>
|
32
|
+
<td valign="top">
|
33
|
+
<h2><span class="refentrytitle"><a name="clutter-Features.top_of_page"></a>Features</span></h2>
|
34
|
+
<p>Features — Run-time detection of Clutter features</p>
|
35
|
+
</td>
|
36
|
+
<td valign="top" align="right"></td>
|
37
|
+
</tr></table></div>
|
38
|
+
<div class="refsynopsisdiv">
|
39
|
+
<a name="clutter-Features.synopsis"></a><h2>Synopsis</h2>
|
40
|
+
<pre class="synopsis">enum <a class="link" href="clutter-Features.html#ClutterFeatureFlags" title="enum ClutterFeatureFlags">ClutterFeatureFlags</a>;
|
41
|
+
<span class="returnvalue">gboolean</span> <a class="link" href="clutter-Features.html#clutter-feature-available" title="clutter_feature_available ()">clutter_feature_available</a> (<em class="parameter"><code><a class="link" href="clutter-Features.html#ClutterFeatureFlags" title="enum ClutterFeatureFlags"><span class="type">ClutterFeatureFlags</span></a> feature</code></em>);
|
42
|
+
<a class="link" href="clutter-Features.html#ClutterFeatureFlags" title="enum ClutterFeatureFlags"><span class="returnvalue">ClutterFeatureFlags</span></a> <a class="link" href="clutter-Features.html#clutter-feature-get-all" title="clutter_feature_get_all ()">clutter_feature_get_all</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
|
43
|
+
</pre>
|
44
|
+
</div>
|
45
|
+
<div class="refsect1">
|
46
|
+
<a name="clutter-Features.description"></a><h2>Description</h2>
|
47
|
+
<p>
|
48
|
+
Parts of Clutter depend on the underlying platform, including the
|
49
|
+
capabilities of the backend used and the OpenGL features exposed through the
|
50
|
+
Clutter and COGL API.
|
51
|
+
</p>
|
52
|
+
<p>
|
53
|
+
It is possible to ask whether Clutter has support for specific features at
|
54
|
+
run-time.
|
55
|
+
</p>
|
56
|
+
<p>
|
57
|
+
See also <code class="function">cogl_get_features()</code> and <span class="type">CoglFeatureFlags</span>
|
58
|
+
</p>
|
59
|
+
</div>
|
60
|
+
<div class="refsect1">
|
61
|
+
<a name="clutter-Features.details"></a><h2>Details</h2>
|
62
|
+
<div class="refsect2">
|
63
|
+
<a name="ClutterFeatureFlags"></a><h3>enum ClutterFeatureFlags</h3>
|
64
|
+
<pre class="programlisting">typedef enum {
|
65
|
+
CLUTTER_FEATURE_TEXTURE_NPOT = (1 << 2),
|
66
|
+
CLUTTER_FEATURE_SYNC_TO_VBLANK = (1 << 3),
|
67
|
+
CLUTTER_FEATURE_TEXTURE_YUV = (1 << 4),
|
68
|
+
CLUTTER_FEATURE_TEXTURE_READ_PIXELS = (1 << 5),
|
69
|
+
CLUTTER_FEATURE_STAGE_STATIC = (1 << 6),
|
70
|
+
CLUTTER_FEATURE_STAGE_USER_RESIZE = (1 << 7),
|
71
|
+
CLUTTER_FEATURE_STAGE_CURSOR = (1 << 8),
|
72
|
+
CLUTTER_FEATURE_SHADERS_GLSL = (1 << 9),
|
73
|
+
CLUTTER_FEATURE_OFFSCREEN = (1 << 10),
|
74
|
+
CLUTTER_FEATURE_STAGE_MULTIPLE = (1 << 11),
|
75
|
+
CLUTTER_FEATURE_SWAP_EVENTS = (1 << 12)
|
76
|
+
} ClutterFeatureFlags;
|
77
|
+
</pre>
|
78
|
+
<p>
|
79
|
+
Runtime flags indicating specific features available via Clutter window
|
80
|
+
sysytem and graphics backend.
|
81
|
+
</p>
|
82
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
83
|
+
<colgroup>
|
84
|
+
<col align="left" valign="top">
|
85
|
+
<col>
|
86
|
+
</colgroup>
|
87
|
+
<tbody>
|
88
|
+
<tr>
|
89
|
+
<td><p><a name="CLUTTER-FEATURE-TEXTURE-NPOT:CAPS"></a><span class="term"><code class="literal">CLUTTER_FEATURE_TEXTURE_NPOT</code></span></p></td>
|
90
|
+
<td>Set if NPOTS textures supported.
|
91
|
+
</td>
|
92
|
+
</tr>
|
93
|
+
<tr>
|
94
|
+
<td><p><a name="CLUTTER-FEATURE-SYNC-TO-VBLANK:CAPS"></a><span class="term"><code class="literal">CLUTTER_FEATURE_SYNC_TO_VBLANK</code></span></p></td>
|
95
|
+
<td>Set if vblank syncing supported.
|
96
|
+
</td>
|
97
|
+
</tr>
|
98
|
+
<tr>
|
99
|
+
<td><p><a name="CLUTTER-FEATURE-TEXTURE-YUV:CAPS"></a><span class="term"><code class="literal">CLUTTER_FEATURE_TEXTURE_YUV</code></span></p></td>
|
100
|
+
<td>Set if YUV based textures supported.
|
101
|
+
</td>
|
102
|
+
</tr>
|
103
|
+
<tr>
|
104
|
+
<td><p><a name="CLUTTER-FEATURE-TEXTURE-READ-PIXELS:CAPS"></a><span class="term"><code class="literal">CLUTTER_FEATURE_TEXTURE_READ_PIXELS</code></span></p></td>
|
105
|
+
<td>Set if texture pixels can be read.
|
106
|
+
</td>
|
107
|
+
</tr>
|
108
|
+
<tr>
|
109
|
+
<td><p><a name="CLUTTER-FEATURE-STAGE-STATIC:CAPS"></a><span class="term"><code class="literal">CLUTTER_FEATURE_STAGE_STATIC</code></span></p></td>
|
110
|
+
<td>Set if stage size if fixed (i.e framebuffer)
|
111
|
+
</td>
|
112
|
+
</tr>
|
113
|
+
<tr>
|
114
|
+
<td><p><a name="CLUTTER-FEATURE-STAGE-USER-RESIZE:CAPS"></a><span class="term"><code class="literal">CLUTTER_FEATURE_STAGE_USER_RESIZE</code></span></p></td>
|
115
|
+
<td>Set if stage is able to be user resized.
|
116
|
+
</td>
|
117
|
+
</tr>
|
118
|
+
<tr>
|
119
|
+
<td><p><a name="CLUTTER-FEATURE-STAGE-CURSOR:CAPS"></a><span class="term"><code class="literal">CLUTTER_FEATURE_STAGE_CURSOR</code></span></p></td>
|
120
|
+
<td>Set if stage has a graphical cursor.
|
121
|
+
</td>
|
122
|
+
</tr>
|
123
|
+
<tr>
|
124
|
+
<td><p><a name="CLUTTER-FEATURE-SHADERS-GLSL:CAPS"></a><span class="term"><code class="literal">CLUTTER_FEATURE_SHADERS_GLSL</code></span></p></td>
|
125
|
+
<td>Set if the backend supports GLSL shaders.
|
126
|
+
</td>
|
127
|
+
</tr>
|
128
|
+
<tr>
|
129
|
+
<td><p><a name="CLUTTER-FEATURE-OFFSCREEN:CAPS"></a><span class="term"><code class="literal">CLUTTER_FEATURE_OFFSCREEN</code></span></p></td>
|
130
|
+
<td>Set if the backend supports offscreen rendering.
|
131
|
+
</td>
|
132
|
+
</tr>
|
133
|
+
<tr>
|
134
|
+
<td><p><a name="CLUTTER-FEATURE-STAGE-MULTIPLE:CAPS"></a><span class="term"><code class="literal">CLUTTER_FEATURE_STAGE_MULTIPLE</code></span></p></td>
|
135
|
+
<td>Set if multiple stages are supported.
|
136
|
+
</td>
|
137
|
+
</tr>
|
138
|
+
<tr>
|
139
|
+
<td><p><a name="CLUTTER-FEATURE-SWAP-EVENTS:CAPS"></a><span class="term"><code class="literal">CLUTTER_FEATURE_SWAP_EVENTS</code></span></p></td>
|
140
|
+
<td>Set if the GLX_INTEL_swap_event is supported.
|
141
|
+
</td>
|
142
|
+
</tr>
|
143
|
+
</tbody>
|
144
|
+
</table></div>
|
145
|
+
<p class="since">Since 0.4</p>
|
146
|
+
</div>
|
147
|
+
<hr>
|
148
|
+
<div class="refsect2">
|
149
|
+
<a name="clutter-feature-available"></a><h3>clutter_feature_available ()</h3>
|
150
|
+
<pre class="programlisting"><span class="returnvalue">gboolean</span> clutter_feature_available (<em class="parameter"><code><a class="link" href="clutter-Features.html#ClutterFeatureFlags" title="enum ClutterFeatureFlags"><span class="type">ClutterFeatureFlags</span></a> feature</code></em>);</pre>
|
151
|
+
<p>
|
152
|
+
Checks whether <em class="parameter"><code>feature</code></em> is available. <em class="parameter"><code>feature</code></em> can be a logical
|
153
|
+
OR of <a class="link" href="clutter-Features.html#ClutterFeatureFlags" title="enum ClutterFeatureFlags"><span class="type">ClutterFeatureFlags</span></a>.
|
154
|
+
</p>
|
155
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
156
|
+
<colgroup>
|
157
|
+
<col align="left" valign="top">
|
158
|
+
<col>
|
159
|
+
</colgroup>
|
160
|
+
<tbody>
|
161
|
+
<tr>
|
162
|
+
<td><p><span class="term"><em class="parameter"><code>feature</code></em> :</span></p></td>
|
163
|
+
<td>a <a class="link" href="clutter-Features.html#ClutterFeatureFlags" title="enum ClutterFeatureFlags"><span class="type">ClutterFeatureFlags</span></a>
|
164
|
+
</td>
|
165
|
+
</tr>
|
166
|
+
<tr>
|
167
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
168
|
+
<td>
|
169
|
+
<code class="literal">TRUE</code> if a feature is available</td>
|
170
|
+
</tr>
|
171
|
+
</tbody>
|
172
|
+
</table></div>
|
173
|
+
<p class="since">Since 0.1.1</p>
|
174
|
+
</div>
|
175
|
+
<hr>
|
176
|
+
<div class="refsect2">
|
177
|
+
<a name="clutter-feature-get-all"></a><h3>clutter_feature_get_all ()</h3>
|
178
|
+
<pre class="programlisting"><a class="link" href="clutter-Features.html#ClutterFeatureFlags" title="enum ClutterFeatureFlags"><span class="returnvalue">ClutterFeatureFlags</span></a> clutter_feature_get_all (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
179
|
+
<p>
|
180
|
+
Returns all the supported features.
|
181
|
+
</p>
|
182
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
183
|
+
<colgroup>
|
184
|
+
<col align="left" valign="top">
|
185
|
+
<col>
|
186
|
+
</colgroup>
|
187
|
+
<tbody><tr>
|
188
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
189
|
+
<td>a logical OR of all the supported features.</td>
|
190
|
+
</tr></tbody>
|
191
|
+
</table></div>
|
192
|
+
<p class="since">Since 0.1.1</p>
|
193
|
+
</div>
|
194
|
+
</div>
|
195
|
+
</div>
|
196
|
+
<div class="footer">
|
197
|
+
<hr>
|
198
|
+
Generated by GTK-Doc V1.18.1</div>
|
199
|
+
</body>
|
200
|
+
</html>
|
@@ -0,0 +1,249 @@
|
|
1
|
+
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
2
|
+
<html>
|
3
|
+
<head>
|
4
|
+
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
5
|
+
<title>GDK Specific Support</title>
|
6
|
+
<meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
|
7
|
+
<link rel="home" href="index.html" title="Clutter Reference Manual">
|
8
|
+
<link rel="up" href="clutterbackends.html" title="Part VII. Clutter Backends">
|
9
|
+
<link rel="prev" href="clutter-Intel-CE3100-CE4100-Specific-Support.html" title="Intel CE3100, CE4100 Specific Support">
|
10
|
+
<link rel="next" href="clutter-Wayland-compositor-specific-support.html" title="Wayland compositor specific support">
|
11
|
+
<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
|
12
|
+
<link rel="stylesheet" href="style.css" type="text/css">
|
13
|
+
</head>
|
14
|
+
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
15
|
+
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
|
16
|
+
<tr valign="middle">
|
17
|
+
<td><a accesskey="p" href="clutter-Intel-CE3100-CE4100-Specific-Support.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
|
18
|
+
<td><a accesskey="u" href="clutterbackends.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
|
19
|
+
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
|
20
|
+
<th width="100%" align="center">Clutter Reference Manual</th>
|
21
|
+
<td><a accesskey="n" href="clutter-Wayland-compositor-specific-support.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
|
22
|
+
</tr>
|
23
|
+
<tr><td colspan="5" class="shortcuts">
|
24
|
+
<a href="#clutter-GDK-Specific-Support.synopsis" class="shortcut">Top</a>
|
25
|
+
|
|
26
|
+
<a href="#clutter-GDK-Specific-Support.description" class="shortcut">Description</a>
|
27
|
+
</td></tr>
|
28
|
+
</table>
|
29
|
+
<div class="refentry">
|
30
|
+
<a name="clutter-GDK-Specific-Support"></a><div class="titlepage"></div>
|
31
|
+
<div class="refnamediv"><table width="100%"><tr>
|
32
|
+
<td valign="top">
|
33
|
+
<h2><span class="refentrytitle"><a name="clutter-GDK-Specific-Support.top_of_page"></a>GDK Specific Support</span></h2>
|
34
|
+
<p>GDK Specific Support — GDK specific API</p>
|
35
|
+
</td>
|
36
|
+
<td valign="top" align="right"></td>
|
37
|
+
</tr></table></div>
|
38
|
+
<div class="refsynopsisdiv">
|
39
|
+
<a name="clutter-GDK-Specific-Support.synopsis"></a><h2>Synopsis</h2>
|
40
|
+
<pre class="synopsis"><span class="returnvalue">void</span> <a class="link" href="clutter-GDK-Specific-Support.html#clutter-gdk-disable-event-retrieval" title="clutter_gdk_disable_event_retrieval ()">clutter_gdk_disable_event_retrieval</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
|
41
|
+
<a class="link" href="ClutterStage.html" title="ClutterStage"><span class="returnvalue">ClutterStage</span></a> * <a class="link" href="clutter-GDK-Specific-Support.html#clutter-gdk-get-stage-from-window" title="clutter_gdk_get_stage_from_window ()">clutter_gdk_get_stage_from_window</a> (<em class="parameter"><code><span class="type">GdkWindow</span> *window</code></em>);
|
42
|
+
<span class="returnvalue">GdkWindow</span> * <a class="link" href="clutter-GDK-Specific-Support.html#clutter-gdk-get-stage-window" title="clutter_gdk_get_stage_window ()">clutter_gdk_get_stage_window</a> (<em class="parameter"><code><a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a> *stage</code></em>);
|
43
|
+
<span class="returnvalue">GdkFilterReturn</span> <a class="link" href="clutter-GDK-Specific-Support.html#clutter-gdk-handle-event" title="clutter_gdk_handle_event ()">clutter_gdk_handle_event</a> (<em class="parameter"><code><span class="type">GdkEvent</span> *event</code></em>);
|
44
|
+
<span class="returnvalue">void</span> <a class="link" href="clutter-GDK-Specific-Support.html#clutter-gdk-set-display" title="clutter_gdk_set_display ()">clutter_gdk_set_display</a> (<em class="parameter"><code><span class="type">GdkDisplay</span> *display</code></em>);
|
45
|
+
<span class="returnvalue">GdkDisplay</span> * <a class="link" href="clutter-GDK-Specific-Support.html#clutter-gdk-get-default-display" title="clutter_gdk_get_default_display ()">clutter_gdk_get_default_display</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
|
46
|
+
<span class="returnvalue">gboolean</span> <a class="link" href="clutter-GDK-Specific-Support.html#clutter-gdk-set-stage-foreign" title="clutter_gdk_set_stage_foreign ()">clutter_gdk_set_stage_foreign</a> (<em class="parameter"><code><a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a> *stage</code></em>,
|
47
|
+
<em class="parameter"><code><span class="type">GdkWindow</span> *window</code></em>);
|
48
|
+
</pre>
|
49
|
+
</div>
|
50
|
+
<div class="refsect1">
|
51
|
+
<a name="clutter-GDK-Specific-Support.description"></a><h2>Description</h2>
|
52
|
+
<p>
|
53
|
+
The GDK backend for Clutter provides some specific API, allowing
|
54
|
+
integration with the GDK API for manipulating the stage window and
|
55
|
+
handling events outside of Clutter.
|
56
|
+
</p>
|
57
|
+
</div>
|
58
|
+
<div class="refsect1">
|
59
|
+
<a name="clutter-GDK-Specific-Support.details"></a><h2>Details</h2>
|
60
|
+
<div class="refsect2">
|
61
|
+
<a name="clutter-gdk-disable-event-retrieval"></a><h3>clutter_gdk_disable_event_retrieval ()</h3>
|
62
|
+
<pre class="programlisting"><span class="returnvalue">void</span> clutter_gdk_disable_event_retrieval (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
63
|
+
<p>
|
64
|
+
Disable the event retrieval in Clutter.
|
65
|
+
</p>
|
66
|
+
<p>
|
67
|
+
Callers of this function have to set up an event filter using the
|
68
|
+
GDK API, and call <a class="link" href="clutter-GDK-Specific-Support.html#clutter-gdk-handle-event" title="clutter_gdk_handle_event ()"><code class="function">clutter_gdk_handle_event()</code></a>.
|
69
|
+
</p>
|
70
|
+
<p>
|
71
|
+
This function should only be used when embedding Clutter into
|
72
|
+
a GDK based toolkit.
|
73
|
+
</p>
|
74
|
+
<p class="since">Since 1.10</p>
|
75
|
+
</div>
|
76
|
+
<hr>
|
77
|
+
<div class="refsect2">
|
78
|
+
<a name="clutter-gdk-get-stage-from-window"></a><h3>clutter_gdk_get_stage_from_window ()</h3>
|
79
|
+
<pre class="programlisting"><a class="link" href="ClutterStage.html" title="ClutterStage"><span class="returnvalue">ClutterStage</span></a> * clutter_gdk_get_stage_from_window (<em class="parameter"><code><span class="type">GdkWindow</span> *window</code></em>);</pre>
|
80
|
+
<p>
|
81
|
+
Gets the stage for a particular X window.
|
82
|
+
</p>
|
83
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
84
|
+
<colgroup>
|
85
|
+
<col align="left" valign="top">
|
86
|
+
<col>
|
87
|
+
</colgroup>
|
88
|
+
<tbody>
|
89
|
+
<tr>
|
90
|
+
<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td>
|
91
|
+
<td>a <span class="type">GtkWindow</span>
|
92
|
+
</td>
|
93
|
+
</tr>
|
94
|
+
<tr>
|
95
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
96
|
+
<td>A <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a>, or% NULL if a stage
|
97
|
+
does not exist for the window. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
|
98
|
+
</td>
|
99
|
+
</tr>
|
100
|
+
</tbody>
|
101
|
+
</table></div>
|
102
|
+
<p class="since">Since 1.10</p>
|
103
|
+
</div>
|
104
|
+
<hr>
|
105
|
+
<div class="refsect2">
|
106
|
+
<a name="clutter-gdk-get-stage-window"></a><h3>clutter_gdk_get_stage_window ()</h3>
|
107
|
+
<pre class="programlisting"><span class="returnvalue">GdkWindow</span> * clutter_gdk_get_stage_window (<em class="parameter"><code><a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a> *stage</code></em>);</pre>
|
108
|
+
<p>
|
109
|
+
Gets the stages GdkWindow.
|
110
|
+
</p>
|
111
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
112
|
+
<colgroup>
|
113
|
+
<col align="left" valign="top">
|
114
|
+
<col>
|
115
|
+
</colgroup>
|
116
|
+
<tbody>
|
117
|
+
<tr>
|
118
|
+
<td><p><span class="term"><em class="parameter"><code>stage</code></em> :</span></p></td>
|
119
|
+
<td>a <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a>
|
120
|
+
</td>
|
121
|
+
</tr>
|
122
|
+
<tr>
|
123
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
124
|
+
<td>A GdkWindow* for the stage window. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
|
125
|
+
</td>
|
126
|
+
</tr>
|
127
|
+
</tbody>
|
128
|
+
</table></div>
|
129
|
+
<p class="since">Since 1.10</p>
|
130
|
+
</div>
|
131
|
+
<hr>
|
132
|
+
<div class="refsect2">
|
133
|
+
<a name="clutter-gdk-handle-event"></a><h3>clutter_gdk_handle_event ()</h3>
|
134
|
+
<pre class="programlisting"><span class="returnvalue">GdkFilterReturn</span> clutter_gdk_handle_event (<em class="parameter"><code><span class="type">GdkEvent</span> *event</code></em>);</pre>
|
135
|
+
<p>
|
136
|
+
This function processes a single GDK event; it can be used to hook
|
137
|
+
into external event processing
|
138
|
+
</p>
|
139
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
140
|
+
<colgroup>
|
141
|
+
<col align="left" valign="top">
|
142
|
+
<col>
|
143
|
+
</colgroup>
|
144
|
+
<tbody>
|
145
|
+
<tr>
|
146
|
+
<td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td>
|
147
|
+
<td>a <span class="type">GdkEvent</span>
|
148
|
+
</td>
|
149
|
+
</tr>
|
150
|
+
<tr>
|
151
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
152
|
+
<td>
|
153
|
+
<span class="type">GdkFilterReturn</span>. <code class="literal">GDK_FILTER_REMOVE</code> indicates that
|
154
|
+
Clutter has internally handled the event and the caller should do
|
155
|
+
no further processing. <code class="literal">GDK_FILTER_CONTINUE</code> indicates that Clutter
|
156
|
+
is either not interested in the event, or has used the event to
|
157
|
+
update internal state without taking any exclusive action.
|
158
|
+
<code class="literal">GDK_FILTER_TRANSLATE</code> will not occur.</td>
|
159
|
+
</tr>
|
160
|
+
</tbody>
|
161
|
+
</table></div>
|
162
|
+
</div>
|
163
|
+
<hr>
|
164
|
+
<div class="refsect2">
|
165
|
+
<a name="clutter-gdk-set-display"></a><h3>clutter_gdk_set_display ()</h3>
|
166
|
+
<pre class="programlisting"><span class="returnvalue">void</span> clutter_gdk_set_display (<em class="parameter"><code><span class="type">GdkDisplay</span> *display</code></em>);</pre>
|
167
|
+
<p>
|
168
|
+
Sets the display connection Clutter should use; must be called
|
169
|
+
before <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a>, <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> or other functions
|
170
|
+
pertaining Clutter's initialization process.
|
171
|
+
</p>
|
172
|
+
<p>
|
173
|
+
If you are parsing the command line arguments by retrieving Clutter's
|
174
|
+
<span class="type">GOptionGroup</span> with <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> and calling
|
175
|
+
<code class="function">g_option_context_parse()</code> yourself, you should also call
|
176
|
+
<a class="link" href="clutter-GDK-Specific-Support.html#clutter-gdk-set-display" title="clutter_gdk_set_display ()"><code class="function">clutter_gdk_set_display()</code></a> before <code class="function">g_option_context_parse()</code>.
|
177
|
+
</p>
|
178
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
179
|
+
<colgroup>
|
180
|
+
<col align="left" valign="top">
|
181
|
+
<col>
|
182
|
+
</colgroup>
|
183
|
+
<tbody><tr>
|
184
|
+
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
|
185
|
+
<td>pointer to a GDK display connection.</td>
|
186
|
+
</tr></tbody>
|
187
|
+
</table></div>
|
188
|
+
<p class="since">Since 0.8</p>
|
189
|
+
</div>
|
190
|
+
<hr>
|
191
|
+
<div class="refsect2">
|
192
|
+
<a name="clutter-gdk-get-default-display"></a><h3>clutter_gdk_get_default_display ()</h3>
|
193
|
+
<pre class="programlisting"><span class="returnvalue">GdkDisplay</span> * clutter_gdk_get_default_display (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
194
|
+
<p>
|
195
|
+
Retrieves the pointer to the default display.
|
196
|
+
</p>
|
197
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
198
|
+
<colgroup>
|
199
|
+
<col align="left" valign="top">
|
200
|
+
<col>
|
201
|
+
</colgroup>
|
202
|
+
<tbody><tr>
|
203
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
204
|
+
<td>the default display. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
|
205
|
+
</td>
|
206
|
+
</tr></tbody>
|
207
|
+
</table></div>
|
208
|
+
<p class="since">Since 0.6</p>
|
209
|
+
</div>
|
210
|
+
<hr>
|
211
|
+
<div class="refsect2">
|
212
|
+
<a name="clutter-gdk-set-stage-foreign"></a><h3>clutter_gdk_set_stage_foreign ()</h3>
|
213
|
+
<pre class="programlisting"><span class="returnvalue">gboolean</span> clutter_gdk_set_stage_foreign (<em class="parameter"><code><a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a> *stage</code></em>,
|
214
|
+
<em class="parameter"><code><span class="type">GdkWindow</span> *window</code></em>);</pre>
|
215
|
+
<p>
|
216
|
+
Target the <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a> to use an existing external <span class="type">GdkWindow</span>
|
217
|
+
</p>
|
218
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
219
|
+
<colgroup>
|
220
|
+
<col align="left" valign="top">
|
221
|
+
<col>
|
222
|
+
</colgroup>
|
223
|
+
<tbody>
|
224
|
+
<tr>
|
225
|
+
<td><p><span class="term"><em class="parameter"><code>stage</code></em> :</span></p></td>
|
226
|
+
<td>a <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a>
|
227
|
+
</td>
|
228
|
+
</tr>
|
229
|
+
<tr>
|
230
|
+
<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td>
|
231
|
+
<td>an existing <span class="type">GdkWindow</span>
|
232
|
+
</td>
|
233
|
+
</tr>
|
234
|
+
<tr>
|
235
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
236
|
+
<td>
|
237
|
+
<code class="literal">TRUE</code> if foreign window is valid</td>
|
238
|
+
</tr>
|
239
|
+
</tbody>
|
240
|
+
</table></div>
|
241
|
+
<p class="since">Since 1.10</p>
|
242
|
+
</div>
|
243
|
+
</div>
|
244
|
+
</div>
|
245
|
+
<div class="footer">
|
246
|
+
<hr>
|
247
|
+
Generated by GTK-Doc V1.18.1</div>
|
248
|
+
</body>
|
249
|
+
</html>
|
@@ -0,0 +1,2550 @@
|
|
1
|
+
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
2
|
+
<html>
|
3
|
+
<head>
|
4
|
+
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
5
|
+
<title>General</title>
|
6
|
+
<meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
|
7
|
+
<link rel="home" href="index.html" title="Clutter Reference Manual">
|
8
|
+
<link rel="up" href="ch10.html" title="General purpose API">
|
9
|
+
<link rel="prev" href="ClutterInputDevice.html" title="ClutterInputDevice">
|
10
|
+
<link rel="next" href="ClutterPath.html" title="ClutterPath">
|
11
|
+
<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
|
12
|
+
<link rel="stylesheet" href="style.css" type="text/css">
|
13
|
+
</head>
|
14
|
+
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
15
|
+
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
|
16
|
+
<tr valign="middle">
|
17
|
+
<td><a accesskey="p" href="ClutterInputDevice.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
|
18
|
+
<td><a accesskey="u" href="ch10.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
|
19
|
+
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
|
20
|
+
<th width="100%" align="center">Clutter Reference Manual</th>
|
21
|
+
<td><a accesskey="n" href="ClutterPath.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
|
22
|
+
</tr>
|
23
|
+
<tr><td colspan="5" class="shortcuts">
|
24
|
+
<a href="#clutter-General.synopsis" class="shortcut">Top</a>
|
25
|
+
|
|
26
|
+
<a href="#clutter-General.description" class="shortcut">Description</a>
|
27
|
+
</td></tr>
|
28
|
+
</table>
|
29
|
+
<div class="refentry">
|
30
|
+
<a name="clutter-General"></a><div class="titlepage"></div>
|
31
|
+
<div class="refnamediv"><table width="100%"><tr>
|
32
|
+
<td valign="top">
|
33
|
+
<h2><span class="refentrytitle"><a name="clutter-General.top_of_page"></a>General</span></h2>
|
34
|
+
<p>General — Various 'global' clutter functions.</p>
|
35
|
+
</td>
|
36
|
+
<td valign="top" align="right"></td>
|
37
|
+
</tr></table></div>
|
38
|
+
<div class="refsynopsisdiv">
|
39
|
+
<a name="clutter-General.synopsis"></a><h2>Synopsis</h2>
|
40
|
+
<pre class="synopsis">#define <a class="link" href="clutter-General.html#CLUTTER-PRIORITY-REDRAW:CAPS" title="CLUTTER_PRIORITY_REDRAW">CLUTTER_PRIORITY_REDRAW</a>
|
41
|
+
|
42
|
+
enum <a class="link" href="clutter-General.html#ClutterInitError" title="enum ClutterInitError">ClutterInitError</a>;
|
43
|
+
<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>,
|
44
|
+
<em class="parameter"><code><span class="type">char</span> ***argv</code></em>);
|
45
|
+
<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>,
|
46
|
+
<em class="parameter"><code><span class="type">char</span> ***argv</code></em>,
|
47
|
+
<em class="parameter"><code>const <span class="type">char</span> *parameter_string</code></em>,
|
48
|
+
<em class="parameter"><code><span class="type">GOptionEntry</span> *entries</code></em>,
|
49
|
+
<em class="parameter"><code>const <span class="type">char</span> *translation_domain</code></em>,
|
50
|
+
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);
|
51
|
+
<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>);
|
52
|
+
<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>
|
53
|
+
(<em class="parameter"><code><span class="type">void</span></code></em>);
|
54
|
+
|
55
|
+
<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>);
|
56
|
+
<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>);
|
57
|
+
<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>);
|
58
|
+
|
59
|
+
<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>);
|
60
|
+
<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>);
|
61
|
+
<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>);
|
62
|
+
<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>);
|
63
|
+
<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>);
|
64
|
+
<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>);
|
65
|
+
<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>);
|
66
|
+
<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>);
|
67
|
+
<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>);
|
68
|
+
enum <a class="link" href="clutter-General.html#ClutterFontFlags" title="enum ClutterFontFlags">ClutterFontFlags</a>;
|
69
|
+
<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>);
|
70
|
+
<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>);
|
71
|
+
<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>);
|
72
|
+
enum <a class="link" href="clutter-General.html#ClutterTextDirection" title="enum ClutterTextDirection">ClutterTextDirection</a>;
|
73
|
+
<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>);
|
74
|
+
<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>);
|
75
|
+
<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>);
|
76
|
+
|
77
|
+
<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>,
|
78
|
+
<em class="parameter"><code><span class="type">GCallback</span> leave_fn</code></em>);
|
79
|
+
<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>);
|
80
|
+
<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>);
|
81
|
+
<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>);
|
82
|
+
<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>,
|
83
|
+
<em class="parameter"><code><span class="type">gpointer</span> data</code></em>);
|
84
|
+
<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>,
|
85
|
+
<em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
|
86
|
+
<em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
|
87
|
+
<em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);
|
88
|
+
<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>,
|
89
|
+
<em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
|
90
|
+
<em class="parameter"><code><span class="type">gpointer</span> data</code></em>);
|
91
|
+
<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>,
|
92
|
+
<em class="parameter"><code><span class="type">guint</span> interval</code></em>,
|
93
|
+
<em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
|
94
|
+
<em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
|
95
|
+
<em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);
|
96
|
+
<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>,
|
97
|
+
<em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
|
98
|
+
<em class="parameter"><code><span class="type">gpointer</span> data</code></em>);
|
99
|
+
<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>
|
100
|
+
(<em class="parameter"><code><span class="type">gint</span> priority</code></em>,
|
101
|
+
<em class="parameter"><code><span class="type">guint</span> fps</code></em>,
|
102
|
+
<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
|
+
<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>,
|
106
|
+
<em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
|
107
|
+
<em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);
|
108
|
+
enum <a class="link" href="clutter-General.html#ClutterRepaintFlags" title="enum ClutterRepaintFlags">ClutterRepaintFlags</a>;
|
109
|
+
<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>
|
110
|
+
(<em class="parameter"><code><a class="link" href="clutter-General.html#ClutterRepaintFlags" title="enum ClutterRepaintFlags"><span class="type">ClutterRepaintFlags</span></a> flags</code></em>,
|
111
|
+
<em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
|
112
|
+
<em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
|
113
|
+
<em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);
|
114
|
+
<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>);
|
115
|
+
|
116
|
+
<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>);
|
117
|
+
<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>);
|
118
|
+
<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>);
|
119
|
+
<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>);
|
120
|
+
<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>);
|
121
|
+
<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>);
|
122
|
+
<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>,
|
123
|
+
<em class="parameter"><code><span class="type">gint</span> id_</code></em>);
|
124
|
+
<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>);
|
125
|
+
|
126
|
+
<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>);
|
127
|
+
</pre>
|
128
|
+
</div>
|
129
|
+
<div class="refsect1">
|
130
|
+
<a name="clutter-General.description"></a><h2>Description</h2>
|
131
|
+
<p>
|
132
|
+
Functions to retrieve various global Clutter resources and other utility
|
133
|
+
functions for mainloops, events and threads
|
134
|
+
</p>
|
135
|
+
<p>
|
136
|
+
</p>
|
137
|
+
<div class="refsect2">
|
138
|
+
<a name="clutter-Threading-Model"></a><h3>Threading Model</h3>
|
139
|
+
<p>Clutter is <span class="emphasis"><em>thread-aware</em></span>: all operations
|
140
|
+
performed by Clutter are assumed to be under the big Clutter lock,
|
141
|
+
which is created when the threading is initialized through
|
142
|
+
<a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a>.</p>
|
143
|
+
<div class="example">
|
144
|
+
<a name="example-Thread-Init"></a><p class="title"><b>Example 9. Thread Initialization</b></p>
|
145
|
+
<div class="example-contents">
|
146
|
+
<p>The code below shows how to correctly initialize Clutter
|
147
|
+
in a multi-threaded environment. These operations are mandatory for
|
148
|
+
applications that wish to use threads with Clutter.</p>
|
149
|
+
<pre class="programlisting">
|
150
|
+
int
|
151
|
+
main (int argc, char *argv[])
|
152
|
+
{
|
153
|
+
/* initialize Clutter */
|
154
|
+
clutter_init (&argc, &argv);
|
155
|
+
|
156
|
+
/* program code */
|
157
|
+
|
158
|
+
/* acquire the main lock */
|
159
|
+
clutter_threads_enter ();
|
160
|
+
|
161
|
+
/* start the main loop */
|
162
|
+
clutter_main ();
|
163
|
+
|
164
|
+
/* release the main lock */
|
165
|
+
clutter_threads_leave ();
|
166
|
+
|
167
|
+
/* clean up */
|
168
|
+
return 0;
|
169
|
+
}
|
170
|
+
</pre>
|
171
|
+
</div>
|
172
|
+
</div>
|
173
|
+
<br class="example-break"><p>This threading model has the caveat that it is only safe to call
|
174
|
+
Clutter's API when the lock has been acquired — which happens
|
175
|
+
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>
|
176
|
+
calls.</p>
|
177
|
+
<p>The only safe and portable way to use the Clutter API in a
|
178
|
+
multi-threaded environment is to never access the API from a thread that
|
179
|
+
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>
|
180
|
+
<p>The common pattern for using threads with Clutter is to use worker
|
181
|
+
threads to perform blocking operations and then install idle or timeout
|
182
|
+
sources with the result when the thread finished.</p>
|
183
|
+
<p>Clutter provides thread-aware variants of <code class="function">g_idle_add()</code> and
|
184
|
+
<code class="function">g_timeout_add()</code> that acquire the Clutter lock before invoking the provided
|
185
|
+
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
|
186
|
+
<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>
|
187
|
+
<p>The example below shows how to use a worker thread to perform a
|
188
|
+
blocking operation, and perform UI updates using the main loop.</p>
|
189
|
+
<div class="example">
|
190
|
+
<a name="worker-thread-example"></a><p class="title"><b>Example 10. A worker thread example</b></p>
|
191
|
+
<div class="example-contents">
|
192
|
+
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
193
|
+
<tbody>
|
194
|
+
<tr>
|
195
|
+
<td class="listing_lines" align="right"><pre>1
|
196
|
+
2
|
197
|
+
3
|
198
|
+
4
|
199
|
+
5
|
200
|
+
6
|
201
|
+
7
|
202
|
+
8
|
203
|
+
9
|
204
|
+
10
|
205
|
+
11
|
206
|
+
12
|
207
|
+
13
|
208
|
+
14
|
209
|
+
15
|
210
|
+
16
|
211
|
+
17
|
212
|
+
18
|
213
|
+
19
|
214
|
+
20
|
215
|
+
21
|
216
|
+
22
|
217
|
+
23
|
218
|
+
24
|
219
|
+
25
|
220
|
+
26
|
221
|
+
27
|
222
|
+
28
|
223
|
+
29
|
224
|
+
30
|
225
|
+
31
|
226
|
+
32
|
227
|
+
33
|
228
|
+
34
|
229
|
+
35
|
230
|
+
36
|
231
|
+
37
|
232
|
+
38
|
233
|
+
39
|
234
|
+
40
|
235
|
+
41
|
236
|
+
42
|
237
|
+
43
|
238
|
+
44
|
239
|
+
45
|
240
|
+
46
|
241
|
+
47
|
242
|
+
48
|
243
|
+
49
|
244
|
+
50
|
245
|
+
51
|
246
|
+
52
|
247
|
+
53
|
248
|
+
54
|
249
|
+
55
|
250
|
+
56
|
251
|
+
57
|
252
|
+
58
|
253
|
+
59
|
254
|
+
60
|
255
|
+
61
|
256
|
+
62
|
257
|
+
63
|
258
|
+
64
|
259
|
+
65
|
260
|
+
66
|
261
|
+
67
|
262
|
+
68
|
263
|
+
69
|
264
|
+
70
|
265
|
+
71
|
266
|
+
72
|
267
|
+
73
|
268
|
+
74
|
269
|
+
75
|
270
|
+
76
|
271
|
+
77
|
272
|
+
78
|
273
|
+
79
|
274
|
+
80
|
275
|
+
81
|
276
|
+
82
|
277
|
+
83
|
278
|
+
84
|
279
|
+
85
|
280
|
+
86
|
281
|
+
87
|
282
|
+
88
|
283
|
+
89
|
284
|
+
90
|
285
|
+
91
|
286
|
+
92
|
287
|
+
93
|
288
|
+
94
|
289
|
+
95
|
290
|
+
96
|
291
|
+
97
|
292
|
+
98
|
293
|
+
99
|
294
|
+
100
|
295
|
+
101
|
296
|
+
102
|
297
|
+
103
|
298
|
+
104
|
299
|
+
105
|
300
|
+
106
|
301
|
+
107
|
302
|
+
108
|
303
|
+
109
|
304
|
+
110
|
305
|
+
111
|
306
|
+
112
|
307
|
+
113
|
308
|
+
114
|
309
|
+
115
|
310
|
+
116
|
311
|
+
117
|
312
|
+
118
|
313
|
+
119
|
314
|
+
120
|
315
|
+
121
|
316
|
+
122
|
317
|
+
123
|
318
|
+
124
|
319
|
+
125
|
320
|
+
126
|
321
|
+
127
|
322
|
+
128
|
323
|
+
129
|
324
|
+
130
|
325
|
+
131
|
326
|
+
132
|
327
|
+
133
|
328
|
+
134
|
329
|
+
135
|
330
|
+
136
|
331
|
+
137
|
332
|
+
138
|
333
|
+
139
|
334
|
+
140
|
335
|
+
141
|
336
|
+
142
|
337
|
+
143
|
338
|
+
144
|
339
|
+
145
|
340
|
+
146
|
341
|
+
147
|
342
|
+
148
|
343
|
+
149
|
344
|
+
150
|
345
|
+
151
|
346
|
+
152
|
347
|
+
153
|
348
|
+
154
|
349
|
+
155
|
350
|
+
156
|
351
|
+
157
|
352
|
+
158
|
353
|
+
159
|
354
|
+
160
|
355
|
+
161
|
356
|
+
162
|
357
|
+
163
|
358
|
+
164
|
359
|
+
165
|
360
|
+
166
|
361
|
+
167
|
362
|
+
168
|
363
|
+
169
|
364
|
+
170
|
365
|
+
171
|
366
|
+
172
|
367
|
+
173
|
368
|
+
174
|
369
|
+
175
|
370
|
+
176
|
371
|
+
177
|
372
|
+
178
|
373
|
+
179
|
374
|
+
180
|
375
|
+
181
|
376
|
+
182
|
377
|
+
183
|
378
|
+
184
|
379
|
+
185
|
380
|
+
186
|
381
|
+
187
|
382
|
+
188
|
383
|
+
189
|
384
|
+
190
|
385
|
+
191
|
386
|
+
192
|
387
|
+
193
|
388
|
+
194
|
389
|
+
195
|
390
|
+
196
|
391
|
+
197
|
392
|
+
198
|
393
|
+
199
|
394
|
+
200
|
395
|
+
201
|
396
|
+
202
|
397
|
+
203
|
398
|
+
204
|
399
|
+
205
|
400
|
+
206
|
401
|
+
207
|
402
|
+
208
|
403
|
+
209
|
404
|
+
210
|
405
|
+
211
|
406
|
+
212
|
407
|
+
213
|
408
|
+
214
|
409
|
+
215
|
410
|
+
216
|
411
|
+
217
|
412
|
+
218
|
413
|
+
219
|
414
|
+
220
|
415
|
+
221
|
416
|
+
222
|
417
|
+
223
|
418
|
+
224
|
419
|
+
225
|
420
|
+
226
|
421
|
+
227
|
422
|
+
228
|
423
|
+
229
|
424
|
+
230
|
425
|
+
231
|
426
|
+
232
|
427
|
+
233
|
428
|
+
234
|
429
|
+
235
|
430
|
+
236
|
431
|
+
237
|
432
|
+
238
|
433
|
+
239
|
434
|
+
240
|
435
|
+
241
|
436
|
+
242
|
437
|
+
243
|
438
|
+
244
|
439
|
+
245
|
440
|
+
246
|
441
|
+
247
|
442
|
+
248
|
443
|
+
249
|
444
|
+
250
|
445
|
+
251
|
446
|
+
252
|
447
|
+
253
|
448
|
+
254
|
449
|
+
255
|
450
|
+
256
|
451
|
+
257
|
452
|
+
258
|
453
|
+
259
|
454
|
+
260
|
455
|
+
261
|
456
|
+
262
|
457
|
+
263
|
458
|
+
264
|
459
|
+
265
|
460
|
+
266
|
461
|
+
267
|
462
|
+
268
|
463
|
+
269
|
464
|
+
270
|
465
|
+
271
|
466
|
+
272
|
467
|
+
273
|
468
|
+
274
|
469
|
+
275
|
470
|
+
276
|
471
|
+
277
|
472
|
+
278
|
473
|
+
279
|
474
|
+
280
|
475
|
+
281
|
476
|
+
282
|
477
|
+
283
|
478
|
+
284
|
479
|
+
285
|
480
|
+
286
|
481
|
+
287
|
482
|
+
288
|
483
|
+
289
|
484
|
+
290
|
485
|
+
291
|
486
|
+
292</pre></td>
|
487
|
+
<td class="listing_code"><pre class="programlisting"><span class="preproc">#include</span><span class="normal"> </span><span class="string"><stdio.h></span>
|
488
|
+
<span class="preproc">#include</span><span class="normal"> </span><span class="string"><stdlib.h></span>
|
489
|
+
<span class="preproc">#include</span><span class="normal"> </span><span class="string"><clutter/clutter.h></span>
|
490
|
+
|
491
|
+
<span class="comment">/* our thread-specific data */</span>
|
492
|
+
<span class="keyword">typedef</span><span class="normal"> </span><span class="keyword">struct</span>
|
493
|
+
<span class="cbracket">{</span>
|
494
|
+
<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>
|
495
|
+
<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>
|
496
|
+
<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>
|
497
|
+
<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>
|
498
|
+
|
499
|
+
<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>
|
500
|
+
<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>
|
501
|
+
<span class="cbracket">}</span><span class="normal"> TestThreadData</span><span class="symbol">;</span>
|
502
|
+
|
503
|
+
<span class="keyword">static</span><span class="normal"> TestThreadData </span><span class="symbol">*</span>
|
504
|
+
<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>
|
505
|
+
<span class="cbracket">{</span>
|
506
|
+
<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>
|
507
|
+
|
508
|
+
<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>
|
509
|
+
|
510
|
+
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> data</span><span class="symbol">;</span>
|
511
|
+
<span class="cbracket">}</span>
|
512
|
+
|
513
|
+
<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
|
514
|
+
<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>
|
515
|
+
<span class="cbracket">{</span>
|
516
|
+
<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>
|
517
|
+
|
518
|
+
<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>
|
519
|
+
<span class="normal"> </span><span class="keyword">return</span><span class="symbol">;</span>
|
520
|
+
|
521
|
+
<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>
|
522
|
+
|
523
|
+
<span class="normal"> </span><span class="function">g_clear_object</span><span class="normal"> </span><span class="symbol">(&</span><span class="normal">data</span><span class="symbol">-></span><span class="normal">progress</span><span class="symbol">);</span>
|
524
|
+
<span class="normal"> </span><span class="function">g_clear_object</span><span class="normal"> </span><span class="symbol">(&</span><span class="normal">data</span><span class="symbol">-></span><span class="normal">label</span><span class="symbol">);</span>
|
525
|
+
<span class="normal"> </span><span class="function">g_clear_object</span><span class="normal"> </span><span class="symbol">(&</span><span class="normal">data</span><span class="symbol">-></span><span class="normal">stage</span><span class="symbol">);</span>
|
526
|
+
<span class="normal"> </span><span class="function">g_clear_object</span><span class="normal"> </span><span class="symbol">(&</span><span class="normal">data</span><span class="symbol">-></span><span class="normal">rect</span><span class="symbol">);</span>
|
527
|
+
<span class="normal"> </span><span class="function">g_clear_object</span><span class="normal"> </span><span class="symbol">(&</span><span class="normal">data</span><span class="symbol">-></span><span class="normal">flip</span><span class="symbol">);</span>
|
528
|
+
<span class="normal"> </span><span class="function">g_clear_object</span><span class="normal"> </span><span class="symbol">(&</span><span class="normal">data</span><span class="symbol">-></span><span class="normal">bounce</span><span class="symbol">);</span>
|
529
|
+
|
530
|
+
<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>
|
531
|
+
<span class="cbracket">}</span>
|
532
|
+
|
533
|
+
<span class="keyword">static</span><span class="normal"> gboolean</span>
|
534
|
+
<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>
|
535
|
+
<span class="cbracket">{</span>
|
536
|
+
<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>
|
537
|
+
|
538
|
+
<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>
|
539
|
+
|
540
|
+
<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">-></span><span class="normal">label</span><span class="symbol">),</span><span class="normal"> </span><span class="string">"Completed"</span><span class="symbol">);</span>
|
541
|
+
|
542
|
+
<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">-></span><span class="normal">rect</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"bounce"</span><span class="symbol">);</span>
|
543
|
+
<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">-></span><span class="normal">rect</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"flip"</span><span class="symbol">);</span>
|
544
|
+
|
545
|
+
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> G_SOURCE_REMOVE</span><span class="symbol">;</span>
|
546
|
+
<span class="cbracket">}</span>
|
547
|
+
|
548
|
+
<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
|
549
|
+
<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>
|
550
|
+
<span class="cbracket">{</span>
|
551
|
+
<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>
|
552
|
+
<span class="normal"> </span><span class="keyword">return</span><span class="symbol">;</span>
|
553
|
+
|
554
|
+
<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>
|
555
|
+
|
556
|
+
<span class="normal"> </span><span class="comment">/* since the TestThreadData structure references Clutter data structures</span>
|
557
|
+
<span class="comment"> * we need to free it from within the same thread that called clutter_main()</span>
|
558
|
+
<span class="comment"> * which means using an idle handler in the main loop.</span>
|
559
|
+
<span class="comment"> *</span>
|
560
|
+
<span class="comment"> * clutter_threads_add_idle() is guaranteed to run the callback passed to</span>
|
561
|
+
<span class="comment"> * to it under the Big Clutter Lock.</span>
|
562
|
+
<span class="comment"> */</span>
|
563
|
+
<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>
|
564
|
+
<span class="normal"> test_thread_done_idle</span><span class="symbol">,</span>
|
565
|
+
<span class="normal"> _data</span><span class="symbol">,</span>
|
566
|
+
<span class="normal"> test_thread_data_free</span><span class="symbol">);</span>
|
567
|
+
<span class="cbracket">}</span>
|
568
|
+
|
569
|
+
<span class="comment">/* thread local storage */</span>
|
570
|
+
<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>
|
571
|
+
|
572
|
+
<span class="keyword">typedef</span><span class="normal"> </span><span class="keyword">struct</span><span class="normal"> </span><span class="cbracket">{</span>
|
573
|
+
<span class="normal"> </span><span class="usertype">gint</span><span class="normal"> count</span><span class="symbol">;</span>
|
574
|
+
<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>
|
575
|
+
<span class="cbracket">}</span><span class="normal"> TestUpdate</span><span class="symbol">;</span>
|
576
|
+
|
577
|
+
<span class="keyword">static</span><span class="normal"> gboolean</span>
|
578
|
+
<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>
|
579
|
+
<span class="cbracket">{</span>
|
580
|
+
<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>
|
581
|
+
<span class="normal"> </span><span class="usertype">guint</span><span class="normal"> width</span><span class="symbol">;</span>
|
582
|
+
<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>
|
583
|
+
|
584
|
+
<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">-></span><span class="normal">thread_data</span><span class="symbol">-></span><span class="normal">label </span><span class="symbol">==</span><span class="normal"> NULL</span><span class="symbol">)</span>
|
585
|
+
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> G_SOURCE_REMOVE</span><span class="symbol">;</span>
|
586
|
+
|
587
|
+
<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">-></span><span class="normal">count</span><span class="symbol">);</span>
|
588
|
+
<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">-></span><span class="normal">thread_data</span><span class="symbol">-></span><span class="normal">label</span><span class="symbol">),</span><span class="normal"> text</span><span class="symbol">);</span>
|
589
|
+
|
590
|
+
<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">-></span><span class="normal">thread_data</span><span class="symbol">-></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>
|
591
|
+
|
592
|
+
<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">-></span><span class="normal">count </span><span class="symbol">==</span><span class="normal"> </span><span class="number">0</span><span class="symbol">)</span>
|
593
|
+
<span class="normal"> width </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
|
594
|
+
<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">-></span><span class="normal">count </span><span class="symbol">==</span><span class="normal"> </span><span class="number">100</span><span class="symbol">)</span>
|
595
|
+
<span class="normal"> width </span><span class="symbol">=</span><span class="normal"> </span><span class="number">350</span><span class="symbol">;</span>
|
596
|
+
<span class="normal"> </span><span class="keyword">else</span>
|
597
|
+
<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">-></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>
|
598
|
+
|
599
|
+
<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">-></span><span class="normal">thread_data</span><span class="symbol">-></span><span class="normal">progress</span><span class="symbol">);</span>
|
600
|
+
<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">-></span><span class="normal">thread_data</span><span class="symbol">-></span><span class="normal">progress</span><span class="symbol">,</span><span class="normal"> width</span><span class="symbol">);</span>
|
601
|
+
<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">-></span><span class="normal">thread_data</span><span class="symbol">-></span><span class="normal">progress</span><span class="symbol">);</span>
|
602
|
+
|
603
|
+
<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>
|
604
|
+
<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>
|
605
|
+
|
606
|
+
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> G_SOURCE_REMOVE</span><span class="symbol">;</span>
|
607
|
+
<span class="cbracket">}</span>
|
608
|
+
|
609
|
+
<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
|
610
|
+
<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>
|
611
|
+
<span class="cbracket">{</span>
|
612
|
+
<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>
|
613
|
+
<span class="normal"> </span><span class="usertype">gint</span><span class="normal"> i</span><span class="symbol">;</span>
|
614
|
+
|
615
|
+
<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">(&</span><span class="normal">test_thread_data</span><span class="symbol">);</span>
|
616
|
+
|
617
|
+
<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"><=</span><span class="normal"> </span><span class="number">100</span><span class="symbol">;</span><span class="normal"> i</span><span class="symbol">++)</span>
|
618
|
+
<span class="normal"> </span><span class="cbracket">{</span>
|
619
|
+
<span class="normal"> </span><span class="usertype">gint</span><span class="normal"> msecs</span><span class="symbol">;</span>
|
620
|
+
|
621
|
+
<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>
|
622
|
+
|
623
|
+
<span class="normal"> </span><span class="comment">/* sleep for a while, to emulate some work being done */</span>
|
624
|
+
<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>
|
625
|
+
|
626
|
+
<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>
|
627
|
+
<span class="normal"> </span><span class="cbracket">{</span>
|
628
|
+
<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>
|
629
|
+
|
630
|
+
<span class="normal"> </span><span class="comment">/* update the UI from within the main loop, making sure that the</span>
|
631
|
+
<span class="comment"> * Big Clutter Lock is held; only one thread at a time can call</span>
|
632
|
+
<span class="comment"> * Clutter API, and it's mandatory to do this from the same thread</span>
|
633
|
+
<span class="comment"> * that called clutter_init()/clutter_main().</span>
|
634
|
+
<span class="comment"> */</span>
|
635
|
+
<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>
|
636
|
+
<span class="normal"> update</span><span class="symbol">-></span><span class="normal">count </span><span class="symbol">=</span><span class="normal"> i</span><span class="symbol">;</span>
|
637
|
+
<span class="normal"> update</span><span class="symbol">-></span><span class="normal">thread_data </span><span class="symbol">=</span><span class="normal"> data</span><span class="symbol">;</span>
|
638
|
+
|
639
|
+
<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>
|
640
|
+
<span class="normal"> update_label_idle</span><span class="symbol">,</span>
|
641
|
+
<span class="normal"> update</span><span class="symbol">,</span><span class="normal"> NULL</span><span class="symbol">);</span>
|
642
|
+
<span class="normal"> </span><span class="cbracket">}</span>
|
643
|
+
<span class="normal"> </span><span class="cbracket">}</span>
|
644
|
+
<span class="cbracket">}</span>
|
645
|
+
|
646
|
+
<span class="keyword">static</span><span class="normal"> gpointer</span>
|
647
|
+
<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>
|
648
|
+
<span class="cbracket">{</span>
|
649
|
+
<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>
|
650
|
+
|
651
|
+
<span class="normal"> </span><span class="function">g_private_set</span><span class="normal"> </span><span class="symbol">(&</span><span class="normal">test_thread_data</span><span class="symbol">,</span><span class="normal"> data</span><span class="symbol">);</span>
|
652
|
+
|
653
|
+
<span class="normal"> </span><span class="comment">/* this function will block */</span>
|
654
|
+
<span class="normal"> </span><span class="function">do_something_very_slow</span><span class="normal"> </span><span class="symbol">();</span>
|
655
|
+
|
656
|
+
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> NULL</span><span class="symbol">;</span>
|
657
|
+
<span class="cbracket">}</span>
|
658
|
+
|
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">count_label </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">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>
|
661
|
+
<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>
|
662
|
+
<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>
|
663
|
+
<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>
|
664
|
+
<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>
|
665
|
+
|
666
|
+
<span class="keyword">static</span><span class="normal"> gboolean</span>
|
667
|
+
<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>
|
668
|
+
<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>
|
669
|
+
<span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> user_data</span><span class="symbol">)</span>
|
670
|
+
<span class="cbracket">{</span>
|
671
|
+
<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>
|
672
|
+
|
673
|
+
<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>
|
674
|
+
<span class="normal"> </span><span class="cbracket">{</span>
|
675
|
+
<span class="normal"> </span><span class="keyword">case</span><span class="normal"> CLUTTER_KEY_s</span><span class="symbol">:</span>
|
676
|
+
<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>
|
677
|
+
|
678
|
+
<span class="normal"> </span><span class="comment">/* start the animations */</span>
|
679
|
+
<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>
|
680
|
+
<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>
|
681
|
+
|
682
|
+
<span class="normal"> </span><span class="comment">/* the data structure holding all our objects */</span>
|
683
|
+
<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>
|
684
|
+
<span class="normal"> data</span><span class="symbol">-></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>
|
685
|
+
<span class="normal"> data</span><span class="symbol">-></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>
|
686
|
+
<span class="normal"> data</span><span class="symbol">-></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>
|
687
|
+
<span class="normal"> data</span><span class="symbol">-></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>
|
688
|
+
<span class="normal"> data</span><span class="symbol">-></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>
|
689
|
+
<span class="normal"> data</span><span class="symbol">-></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>
|
690
|
+
|
691
|
+
<span class="normal"> </span><span class="comment">/* start the thread that updates the counter and the progress bar */</span>
|
692
|
+
<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>
|
693
|
+
|
694
|
+
<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>
|
695
|
+
|
696
|
+
<span class="normal"> </span><span class="keyword">case</span><span class="normal"> CLUTTER_KEY_q</span><span class="symbol">:</span>
|
697
|
+
<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>
|
698
|
+
|
699
|
+
<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>
|
700
|
+
|
701
|
+
<span class="label"> default:</span>
|
702
|
+
<span class="normal"> </span><span class="keyword">break</span><span class="symbol">;</span>
|
703
|
+
<span class="normal"> </span><span class="cbracket">}</span>
|
704
|
+
|
705
|
+
<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>
|
706
|
+
<span class="cbracket">}</span>
|
707
|
+
|
708
|
+
<span class="type">int</span>
|
709
|
+
<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>
|
710
|
+
<span class="cbracket">{</span>
|
711
|
+
<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>
|
712
|
+
<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>
|
713
|
+
<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>
|
714
|
+
<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>
|
715
|
+
|
716
|
+
<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">(&</span><span class="normal">argc</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</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>
|
717
|
+
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> </span><span class="number">1</span><span class="symbol">;</span>
|
718
|
+
|
719
|
+
<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>
|
720
|
+
<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>
|
721
|
+
<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>
|
722
|
+
<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>
|
723
|
+
<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>
|
724
|
+
<span class="normal"> </span>
|
725
|
+
<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>
|
726
|
+
<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>
|
727
|
+
<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>
|
728
|
+
|
729
|
+
<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>
|
730
|
+
<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>
|
731
|
+
<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>
|
732
|
+
|
733
|
+
<span class="normal"> </span><span class="comment">/* a progress bar */</span>
|
734
|
+
<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>
|
735
|
+
<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>
|
736
|
+
<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>
|
737
|
+
<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>
|
738
|
+
<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>
|
739
|
+
|
740
|
+
<span class="normal"> </span><span class="comment">/* an actor we bounce around */</span>
|
741
|
+
<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>
|
742
|
+
<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>
|
743
|
+
<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>
|
744
|
+
<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>
|
745
|
+
<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>
|
746
|
+
<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>
|
747
|
+
<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>
|
748
|
+
|
749
|
+
<span class="normal"> </span><span class="comment">/* two transitions we use to bounce rect around */</span>
|
750
|
+
<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>
|
751
|
+
<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>
|
752
|
+
<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>
|
753
|
+
<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>
|
754
|
+
<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>
|
755
|
+
<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>
|
756
|
+
<span class="normal"> flip </span><span class="symbol">=</span><span class="normal"> transition</span><span class="symbol">;</span>
|
757
|
+
|
758
|
+
<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>
|
759
|
+
<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">&</span><span class="normal">start</span><span class="symbol">);</span>
|
760
|
+
<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">&</span><span class="normal">end</span><span class="symbol">);</span>
|
761
|
+
<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>
|
762
|
+
<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>
|
763
|
+
<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>
|
764
|
+
<span class="normal"> bounce </span><span class="symbol">=</span><span class="normal"> transition</span><span class="symbol">;</span>
|
765
|
+
|
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">"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>
|
768
|
+
<span class="normal"> NULL</span><span class="symbol">);</span>
|
769
|
+
<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>
|
770
|
+
<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>
|
771
|
+
<span class="normal"> NULL</span><span class="symbol">);</span>
|
772
|
+
|
773
|
+
<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>
|
774
|
+
|
775
|
+
<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>
|
776
|
+
|
777
|
+
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> EXIT_SUCCESS</span><span class="symbol">;</span>
|
778
|
+
<span class="cbracket">}</span></pre></td>
|
779
|
+
</tr>
|
780
|
+
</tbody>
|
781
|
+
</table>
|
782
|
+
</div>
|
783
|
+
|
784
|
+
</div>
|
785
|
+
<br class="example-break">
|
786
|
+
</div>
|
787
|
+
<p>
|
788
|
+
</p>
|
789
|
+
</div>
|
790
|
+
<div class="refsect1">
|
791
|
+
<a name="clutter-General.details"></a><h2>Details</h2>
|
792
|
+
<div class="refsect2">
|
793
|
+
<a name="CLUTTER-PRIORITY-REDRAW:CAPS"></a><h3>CLUTTER_PRIORITY_REDRAW</h3>
|
794
|
+
<pre class="programlisting">#define CLUTTER_PRIORITY_REDRAW (G_PRIORITY_HIGH_IDLE + 50)
|
795
|
+
</pre>
|
796
|
+
<p>
|
797
|
+
Priority of the redraws. This is chosen to be lower than the GTK+
|
798
|
+
redraw and resize priorities, because in application with both
|
799
|
+
GTK+ and Clutter it's more likely that the Clutter part will be
|
800
|
+
continually animating (and thus able to starve GTK+) than
|
801
|
+
vice-versa.
|
802
|
+
</p>
|
803
|
+
<p class="since">Since 0.8</p>
|
804
|
+
</div>
|
805
|
+
<hr>
|
806
|
+
<div class="refsect2">
|
807
|
+
<a name="ClutterInitError"></a><h3>enum ClutterInitError</h3>
|
808
|
+
<pre class="programlisting">typedef enum {
|
809
|
+
CLUTTER_INIT_SUCCESS = 1,
|
810
|
+
CLUTTER_INIT_ERROR_UNKNOWN = 0,
|
811
|
+
CLUTTER_INIT_ERROR_THREADS = -1,
|
812
|
+
CLUTTER_INIT_ERROR_BACKEND = -2,
|
813
|
+
CLUTTER_INIT_ERROR_INTERNAL = -3
|
814
|
+
} ClutterInitError;
|
815
|
+
</pre>
|
816
|
+
<p>
|
817
|
+
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>.
|
818
|
+
</p>
|
819
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
820
|
+
<colgroup>
|
821
|
+
<col align="left" valign="top">
|
822
|
+
<col>
|
823
|
+
</colgroup>
|
824
|
+
<tbody>
|
825
|
+
<tr>
|
826
|
+
<td><p><a name="CLUTTER-INIT-SUCCESS:CAPS"></a><span class="term"><code class="literal">CLUTTER_INIT_SUCCESS</code></span></p></td>
|
827
|
+
<td>Initialisation successful
|
828
|
+
</td>
|
829
|
+
</tr>
|
830
|
+
<tr>
|
831
|
+
<td><p><a name="CLUTTER-INIT-ERROR-UNKNOWN:CAPS"></a><span class="term"><code class="literal">CLUTTER_INIT_ERROR_UNKNOWN</code></span></p></td>
|
832
|
+
<td>Unknown error
|
833
|
+
</td>
|
834
|
+
</tr>
|
835
|
+
<tr>
|
836
|
+
<td><p><a name="CLUTTER-INIT-ERROR-THREADS:CAPS"></a><span class="term"><code class="literal">CLUTTER_INIT_ERROR_THREADS</code></span></p></td>
|
837
|
+
<td>Thread initialisation failed
|
838
|
+
</td>
|
839
|
+
</tr>
|
840
|
+
<tr>
|
841
|
+
<td><p><a name="CLUTTER-INIT-ERROR-BACKEND:CAPS"></a><span class="term"><code class="literal">CLUTTER_INIT_ERROR_BACKEND</code></span></p></td>
|
842
|
+
<td>Backend initialisation failed
|
843
|
+
</td>
|
844
|
+
</tr>
|
845
|
+
<tr>
|
846
|
+
<td><p><a name="CLUTTER-INIT-ERROR-INTERNAL:CAPS"></a><span class="term"><code class="literal">CLUTTER_INIT_ERROR_INTERNAL</code></span></p></td>
|
847
|
+
<td>Internal error
|
848
|
+
</td>
|
849
|
+
</tr>
|
850
|
+
</tbody>
|
851
|
+
</table></div>
|
852
|
+
<p class="since">Since 0.2</p>
|
853
|
+
</div>
|
854
|
+
<hr>
|
855
|
+
<div class="refsect2">
|
856
|
+
<a name="clutter-init"></a><h3>clutter_init ()</h3>
|
857
|
+
<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>,
|
858
|
+
<em class="parameter"><code><span class="type">char</span> ***argv</code></em>);</pre>
|
859
|
+
<p>
|
860
|
+
Initialises everything needed to operate with Clutter and parses some
|
861
|
+
standard command line options; <em class="parameter"><code>argc</code></em> and <em class="parameter"><code>argv</code></em> are adjusted accordingly
|
862
|
+
so your own code will never see those standard arguments.
|
863
|
+
</p>
|
864
|
+
<p>
|
865
|
+
It is safe to call this function multiple times.
|
866
|
+
</p>
|
867
|
+
<p>
|
868
|
+
</p>
|
869
|
+
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
|
870
|
+
<h3 class="title">Note</h3>This function will not abort in case of errors during
|
871
|
+
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
|
872
|
+
stderr, and will return an error code. It is up to the application
|
873
|
+
code to handle this case. If you need to display the error message
|
874
|
+
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>
|
875
|
+
pointer.</div>
|
876
|
+
<p>
|
877
|
+
</p>
|
878
|
+
<p>
|
879
|
+
If this function fails, and returns an error code, any subsequent
|
880
|
+
Clutter API will have undefined behaviour - including segmentation
|
881
|
+
faults and assertion failures. Make sure to handle the returned
|
882
|
+
<a class="link" href="clutter-General.html#ClutterInitError" title="enum ClutterInitError"><span class="type">ClutterInitError</span></a> enumeration value.
|
883
|
+
</p>
|
884
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
885
|
+
<colgroup>
|
886
|
+
<col align="left" valign="top">
|
887
|
+
<col>
|
888
|
+
</colgroup>
|
889
|
+
<tbody>
|
890
|
+
<tr>
|
891
|
+
<td><p><span class="term"><em class="parameter"><code>argc</code></em> :</span></p></td>
|
892
|
+
<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>
|
893
|
+
</td>
|
894
|
+
</tr>
|
895
|
+
<tr>
|
896
|
+
<td><p><span class="term"><em class="parameter"><code>argv</code></em> :</span></p></td>
|
897
|
+
<td>A pointer to an array
|
898
|
+
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>
|
899
|
+
</td>
|
900
|
+
</tr>
|
901
|
+
<tr>
|
902
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
903
|
+
<td>a <a class="link" href="clutter-General.html#ClutterInitError" title="enum ClutterInitError"><span class="type">ClutterInitError</span></a> value</td>
|
904
|
+
</tr>
|
905
|
+
</tbody>
|
906
|
+
</table></div>
|
907
|
+
</div>
|
908
|
+
<hr>
|
909
|
+
<div class="refsect2">
|
910
|
+
<a name="clutter-init-with-args"></a><h3>clutter_init_with_args ()</h3>
|
911
|
+
<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>,
|
912
|
+
<em class="parameter"><code><span class="type">char</span> ***argv</code></em>,
|
913
|
+
<em class="parameter"><code>const <span class="type">char</span> *parameter_string</code></em>,
|
914
|
+
<em class="parameter"><code><span class="type">GOptionEntry</span> *entries</code></em>,
|
915
|
+
<em class="parameter"><code>const <span class="type">char</span> *translation_domain</code></em>,
|
916
|
+
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
|
917
|
+
<p>
|
918
|
+
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,
|
919
|
+
it allows you to add your own command line options, and it
|
920
|
+
automatically generates nicely formatted <code class="option">--help</code>
|
921
|
+
output. Note that your program will be terminated after writing
|
922
|
+
out the help output. Also note that, in case of error, the
|
923
|
+
error message will be placed inside <em class="parameter"><code>error</code></em> instead of being
|
924
|
+
printed on the display.
|
925
|
+
</p>
|
926
|
+
<p>
|
927
|
+
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
|
928
|
+
any subsequent call to any other Clutter API will result in undefined
|
929
|
+
behaviour - including segmentation faults.
|
930
|
+
</p>
|
931
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
932
|
+
<colgroup>
|
933
|
+
<col align="left" valign="top">
|
934
|
+
<col>
|
935
|
+
</colgroup>
|
936
|
+
<tbody>
|
937
|
+
<tr>
|
938
|
+
<td><p><span class="term"><em class="parameter"><code>argc</code></em> :</span></p></td>
|
939
|
+
<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>
|
940
|
+
</td>
|
941
|
+
</tr>
|
942
|
+
<tr>
|
943
|
+
<td><p><span class="term"><em class="parameter"><code>argv</code></em> :</span></p></td>
|
944
|
+
<td>a pointer to the array
|
945
|
+
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>
|
946
|
+
</td>
|
947
|
+
</tr>
|
948
|
+
<tr>
|
949
|
+
<td><p><span class="term"><em class="parameter"><code>parameter_string</code></em> :</span></p></td>
|
950
|
+
<td>a string which is displayed in the
|
951
|
+
first line of <code class="option">--help</code> output, after
|
952
|
+
<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>
|
953
|
+
</td>
|
954
|
+
</tr>
|
955
|
+
<tr>
|
956
|
+
<td><p><span class="term"><em class="parameter"><code>entries</code></em> :</span></p></td>
|
957
|
+
<td>a <code class="literal">NULL</code> terminated array of
|
958
|
+
<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>
|
959
|
+
</td>
|
960
|
+
</tr>
|
961
|
+
<tr>
|
962
|
+
<td><p><span class="term"><em class="parameter"><code>translation_domain</code></em> :</span></p></td>
|
963
|
+
<td>a translation domain to use for
|
964
|
+
translating the <code class="option">--help</code> output for the options in
|
965
|
+
<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>
|
966
|
+
</td>
|
967
|
+
</tr>
|
968
|
+
<tr>
|
969
|
+
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
|
970
|
+
<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>
|
971
|
+
</td>
|
972
|
+
</tr>
|
973
|
+
<tr>
|
974
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
975
|
+
<td>
|
976
|
+
<a class="link" href="clutter-General.html#CLUTTER-INIT-SUCCESS:CAPS"><code class="literal">CLUTTER_INIT_SUCCESS</code></a> if Clutter has been successfully
|
977
|
+
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
|
978
|
+
error.</td>
|
979
|
+
</tr>
|
980
|
+
</tbody>
|
981
|
+
</table></div>
|
982
|
+
<p class="since">Since 0.2</p>
|
983
|
+
</div>
|
984
|
+
<hr>
|
985
|
+
<div class="refsect2">
|
986
|
+
<a name="clutter-get-option-group"></a><h3>clutter_get_option_group ()</h3>
|
987
|
+
<pre class="programlisting"><span class="returnvalue">GOptionGroup</span> * clutter_get_option_group (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
988
|
+
<p>
|
989
|
+
Returns a <span class="type">GOptionGroup</span> for the command line arguments recognized
|
990
|
+
by Clutter. You should add this group to your <span class="type">GOptionContext</span> with
|
991
|
+
<code class="function">g_option_context_add_group()</code>, if you are using <code class="function">g_option_context_parse()</code>
|
992
|
+
to parse your commandline arguments.
|
993
|
+
</p>
|
994
|
+
<p>
|
995
|
+
Calling <code class="function">g_option_context_parse()</code> with Clutter's <span class="type">GOptionGroup</span> will result
|
996
|
+
in Clutter's initialization. That is, the following code:
|
997
|
+
</p>
|
998
|
+
<p>
|
999
|
+
</p>
|
1000
|
+
<div class="informalexample">
|
1001
|
+
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
1002
|
+
<tbody>
|
1003
|
+
<tr>
|
1004
|
+
<td class="listing_lines" align="right"><pre>1
|
1005
|
+
2</pre></td>
|
1006
|
+
<td class="listing_code"><pre class="programlisting"><span class="function">g_option_context_set_main_group</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="clutter-General.html#clutter-get-option-group">clutter_get_option_group</a></span><span class="normal"> </span><span class="symbol">());</span>
|
1007
|
+
<span class="normal">res </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_option_context_parse</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">argc</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">argc</span><span class="symbol">,</span><span class="normal"> NULL</span><span class="symbol">);</span></pre></td>
|
1008
|
+
</tr>
|
1009
|
+
</tbody>
|
1010
|
+
</table>
|
1011
|
+
</div>
|
1012
|
+
|
1013
|
+
<p>
|
1014
|
+
</p>
|
1015
|
+
<p>
|
1016
|
+
is functionally equivalent to:
|
1017
|
+
</p>
|
1018
|
+
<p>
|
1019
|
+
</p>
|
1020
|
+
<div class="informalexample">
|
1021
|
+
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
1022
|
+
<tbody>
|
1023
|
+
<tr>
|
1024
|
+
<td class="listing_lines" align="right"><pre>1</pre></td>
|
1025
|
+
<td class="listing_code"><pre class="programlisting"><span class="function"><a href="clutter-General.html#clutter-init">clutter_init</a></span><span class="normal"> </span><span class="symbol">(&</span><span class="normal">argc</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">argv</span><span class="symbol">);</span></pre></td>
|
1026
|
+
</tr>
|
1027
|
+
</tbody>
|
1028
|
+
</table>
|
1029
|
+
</div>
|
1030
|
+
|
1031
|
+
<p>
|
1032
|
+
</p>
|
1033
|
+
<p>
|
1034
|
+
After <code class="function">g_option_context_parse()</code> on a <span class="type">GOptionContext</span> containing the
|
1035
|
+
Clutter <span class="type">GOptionGroup</span> has returned <code class="literal">TRUE</code>, Clutter is guaranteed to be
|
1036
|
+
initialized.
|
1037
|
+
</p>
|
1038
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1039
|
+
<colgroup>
|
1040
|
+
<col align="left" valign="top">
|
1041
|
+
<col>
|
1042
|
+
</colgroup>
|
1043
|
+
<tbody><tr>
|
1044
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1045
|
+
<td>a <span class="type">GOptionGroup</span> for the commandline arguments
|
1046
|
+
recognized by Clutter. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
|
1047
|
+
</td>
|
1048
|
+
</tr></tbody>
|
1049
|
+
</table></div>
|
1050
|
+
<p class="since">Since 0.2</p>
|
1051
|
+
</div>
|
1052
|
+
<hr>
|
1053
|
+
<div class="refsect2">
|
1054
|
+
<a name="clutter-get-option-group-without-init"></a><h3>clutter_get_option_group_without_init ()</h3>
|
1055
|
+
<pre class="programlisting"><span class="returnvalue">GOptionGroup</span> * clutter_get_option_group_without_init
|
1056
|
+
(<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
1057
|
+
<p>
|
1058
|
+
Returns a <span class="type">GOptionGroup</span> for the command line arguments recognized
|
1059
|
+
by Clutter. You should add this group to your <span class="type">GOptionContext</span> with
|
1060
|
+
<code class="function">g_option_context_add_group()</code>, if you are using <code class="function">g_option_context_parse()</code>
|
1061
|
+
to parse your commandline arguments.
|
1062
|
+
</p>
|
1063
|
+
<p>
|
1064
|
+
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
|
1065
|
+
the <span class="type">GOptionGroup</span> returned by this function requires a subsequent explicit
|
1066
|
+
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
|
1067
|
+
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
|
1068
|
+
<code class="function"><code class="function">gtk_clutter_init()</code></code>.
|
1069
|
+
</p>
|
1070
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1071
|
+
<colgroup>
|
1072
|
+
<col align="left" valign="top">
|
1073
|
+
<col>
|
1074
|
+
</colgroup>
|
1075
|
+
<tbody><tr>
|
1076
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1077
|
+
<td>a <span class="type">GOptionGroup</span> for the commandline arguments
|
1078
|
+
recognized by Clutter. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
|
1079
|
+
</td>
|
1080
|
+
</tr></tbody>
|
1081
|
+
</table></div>
|
1082
|
+
<p class="since">Since 0.8.2</p>
|
1083
|
+
</div>
|
1084
|
+
<hr>
|
1085
|
+
<div class="refsect2">
|
1086
|
+
<a name="clutter-main"></a><h3>clutter_main ()</h3>
|
1087
|
+
<pre class="programlisting"><span class="returnvalue">void</span> clutter_main (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
1088
|
+
<p>
|
1089
|
+
Starts the Clutter mainloop.
|
1090
|
+
</p>
|
1091
|
+
</div>
|
1092
|
+
<hr>
|
1093
|
+
<div class="refsect2">
|
1094
|
+
<a name="clutter-main-quit"></a><h3>clutter_main_quit ()</h3>
|
1095
|
+
<pre class="programlisting"><span class="returnvalue">void</span> clutter_main_quit (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
1096
|
+
<p>
|
1097
|
+
Terminates the Clutter mainloop.
|
1098
|
+
</p>
|
1099
|
+
</div>
|
1100
|
+
<hr>
|
1101
|
+
<div class="refsect2">
|
1102
|
+
<a name="clutter-main-level"></a><h3>clutter_main_level ()</h3>
|
1103
|
+
<pre class="programlisting"><span class="returnvalue">gint</span> clutter_main_level (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
1104
|
+
<p>
|
1105
|
+
Retrieves the depth of the Clutter mainloop.
|
1106
|
+
</p>
|
1107
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1108
|
+
<colgroup>
|
1109
|
+
<col align="left" valign="top">
|
1110
|
+
<col>
|
1111
|
+
</colgroup>
|
1112
|
+
<tbody><tr>
|
1113
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1114
|
+
<td>The level of the mainloop.</td>
|
1115
|
+
</tr></tbody>
|
1116
|
+
</table></div>
|
1117
|
+
</div>
|
1118
|
+
<hr>
|
1119
|
+
<div class="refsect2">
|
1120
|
+
<a name="clutter-get-debug-enabled"></a><h3>clutter_get_debug_enabled ()</h3>
|
1121
|
+
<pre class="programlisting"><span class="returnvalue">gboolean</span> clutter_get_debug_enabled (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
1122
|
+
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
|
1123
|
+
<h3 class="title">Warning</h3>
|
1124
|
+
<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>
|
1125
|
+
</div>
|
1126
|
+
<p>
|
1127
|
+
Check if Clutter has debugging enabled.
|
1128
|
+
</p>
|
1129
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1130
|
+
<colgroup>
|
1131
|
+
<col align="left" valign="top">
|
1132
|
+
<col>
|
1133
|
+
</colgroup>
|
1134
|
+
<tbody><tr>
|
1135
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1136
|
+
<td><code class="literal">FALSE</code></td>
|
1137
|
+
</tr></tbody>
|
1138
|
+
</table></div>
|
1139
|
+
</div>
|
1140
|
+
<hr>
|
1141
|
+
<div class="refsect2">
|
1142
|
+
<a name="clutter-get-show-fps"></a><h3>clutter_get_show_fps ()</h3>
|
1143
|
+
<pre class="programlisting"><span class="returnvalue">gboolean</span> clutter_get_show_fps (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
1144
|
+
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
|
1145
|
+
<h3 class="title">Warning</h3>
|
1146
|
+
<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
|
1147
|
+
variable or the configuration file to determine whether Clutter should
|
1148
|
+
print out the FPS counter on the console.</p>
|
1149
|
+
</div>
|
1150
|
+
<p>
|
1151
|
+
Returns whether Clutter should print out the frames per second on the
|
1152
|
+
console. You can enable this setting either using the
|
1153
|
+
<code class="literal">CLUTTER_SHOW_FPS</code> environment variable or passing
|
1154
|
+
the <code class="literal">--clutter-show-fps</code> command line argument. *
|
1155
|
+
</p>
|
1156
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1157
|
+
<colgroup>
|
1158
|
+
<col align="left" valign="top">
|
1159
|
+
<col>
|
1160
|
+
</colgroup>
|
1161
|
+
<tbody><tr>
|
1162
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1163
|
+
<td>
|
1164
|
+
<code class="literal">TRUE</code> if Clutter should show the FPS.</td>
|
1165
|
+
</tr></tbody>
|
1166
|
+
</table></div>
|
1167
|
+
<p class="since">Since 0.4</p>
|
1168
|
+
</div>
|
1169
|
+
<hr>
|
1170
|
+
<div class="refsect2">
|
1171
|
+
<a name="clutter-get-timestamp"></a><h3>clutter_get_timestamp ()</h3>
|
1172
|
+
<pre class="programlisting"><span class="returnvalue">gulong</span> clutter_get_timestamp (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
1173
|
+
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
|
1174
|
+
<h3 class="title">Warning</h3>
|
1175
|
+
<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
|
1176
|
+
timing source</p>
|
1177
|
+
</div>
|
1178
|
+
<p>
|
1179
|
+
Returns the approximate number of microseconds passed since Clutter was
|
1180
|
+
intialised.
|
1181
|
+
</p>
|
1182
|
+
<p>
|
1183
|
+
This function shdould not be used by application code.
|
1184
|
+
</p>
|
1185
|
+
<p>
|
1186
|
+
The output of this function depends on whether Clutter was configured to
|
1187
|
+
enable its debugging code paths, so it's less useful than intended.
|
1188
|
+
</p>
|
1189
|
+
<p>
|
1190
|
+
Since Clutter 1.10, this function is an alias to <code class="function">g_get_monotonic_time()</code>
|
1191
|
+
if Clutter was configured to enable the debugging code paths.
|
1192
|
+
</p>
|
1193
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1194
|
+
<colgroup>
|
1195
|
+
<col align="left" valign="top">
|
1196
|
+
<col>
|
1197
|
+
</colgroup>
|
1198
|
+
<tbody><tr>
|
1199
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1200
|
+
<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
|
1201
|
+
zero if Clutter was not configured with debugging code paths.</td>
|
1202
|
+
</tr></tbody>
|
1203
|
+
</table></div>
|
1204
|
+
</div>
|
1205
|
+
<hr>
|
1206
|
+
<div class="refsect2">
|
1207
|
+
<a name="clutter-get-actor-by-gid"></a><h3>clutter_get_actor_by_gid ()</h3>
|
1208
|
+
<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>
|
1209
|
+
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
|
1210
|
+
<h3 class="title">Warning</h3>
|
1211
|
+
<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>
|
1212
|
+
</div>
|
1213
|
+
<p>
|
1214
|
+
Retrieves the <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> with <em class="parameter"><code>id_</code></em>.
|
1215
|
+
</p>
|
1216
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1217
|
+
<colgroup>
|
1218
|
+
<col align="left" valign="top">
|
1219
|
+
<col>
|
1220
|
+
</colgroup>
|
1221
|
+
<tbody>
|
1222
|
+
<tr>
|
1223
|
+
<td><p><span class="term"><em class="parameter"><code>id_</code></em> :</span></p></td>
|
1224
|
+
<td>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> unique id.</td>
|
1225
|
+
</tr>
|
1226
|
+
<tr>
|
1227
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1228
|
+
<td>the actor with the passed id or <code class="literal">NULL</code>.
|
1229
|
+
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>
|
1230
|
+
</td>
|
1231
|
+
</tr>
|
1232
|
+
</tbody>
|
1233
|
+
</table></div>
|
1234
|
+
<p class="since">Since 0.6</p>
|
1235
|
+
</div>
|
1236
|
+
<hr>
|
1237
|
+
<div class="refsect2">
|
1238
|
+
<a name="clutter-set-default-frame-rate"></a><h3>clutter_set_default_frame_rate ()</h3>
|
1239
|
+
<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>
|
1240
|
+
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
|
1241
|
+
<h3 class="title">Warning</h3>
|
1242
|
+
<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>
|
1243
|
+
</div>
|
1244
|
+
<p>
|
1245
|
+
Sets the default frame rate. This frame rate will be used to limit
|
1246
|
+
the number of frames drawn if Clutter is not able to synchronize
|
1247
|
+
with the vertical refresh rate of the display. When synchronization
|
1248
|
+
is possible, this value is ignored.
|
1249
|
+
</p>
|
1250
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1251
|
+
<colgroup>
|
1252
|
+
<col align="left" valign="top">
|
1253
|
+
<col>
|
1254
|
+
</colgroup>
|
1255
|
+
<tbody><tr>
|
1256
|
+
<td><p><span class="term"><em class="parameter"><code>frames_per_sec</code></em> :</span></p></td>
|
1257
|
+
<td>the new default frame rate</td>
|
1258
|
+
</tr></tbody>
|
1259
|
+
</table></div>
|
1260
|
+
<p class="since">Since 0.6</p>
|
1261
|
+
</div>
|
1262
|
+
<hr>
|
1263
|
+
<div class="refsect2">
|
1264
|
+
<a name="clutter-get-default-frame-rate"></a><h3>clutter_get_default_frame_rate ()</h3>
|
1265
|
+
<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>
|
1266
|
+
<p>
|
1267
|
+
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>.
|
1268
|
+
</p>
|
1269
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1270
|
+
<colgroup>
|
1271
|
+
<col align="left" valign="top">
|
1272
|
+
<col>
|
1273
|
+
</colgroup>
|
1274
|
+
<tbody><tr>
|
1275
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1276
|
+
<td>the default frame rate</td>
|
1277
|
+
</tr></tbody>
|
1278
|
+
</table></div>
|
1279
|
+
<p class="since">Since 0.6</p>
|
1280
|
+
</div>
|
1281
|
+
<hr>
|
1282
|
+
<div class="refsect2">
|
1283
|
+
<a name="clutter-set-motion-events-enabled"></a><h3>clutter_set_motion_events_enabled ()</h3>
|
1284
|
+
<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>
|
1285
|
+
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
|
1286
|
+
<h3 class="title">Warning</h3>
|
1287
|
+
<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>
|
1288
|
+
</div>
|
1289
|
+
<p>
|
1290
|
+
Sets whether per-actor motion events should be enabled or not on
|
1291
|
+
all <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a>s managed by Clutter.
|
1292
|
+
</p>
|
1293
|
+
<p>
|
1294
|
+
If <em class="parameter"><code>enable</code></em> is <code class="literal">FALSE</code> the following events will not work:
|
1295
|
+
</p>
|
1296
|
+
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
|
1297
|
+
<li class="listitem"><p>ClutterActor::motion-event, unless on the
|
1298
|
+
<a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a></p></li>
|
1299
|
+
<li class="listitem"><p>ClutterActor::enter-event</p></li>
|
1300
|
+
<li class="listitem"><p>ClutterActor::leave-event</p></li>
|
1301
|
+
</ul></div>
|
1302
|
+
<p>
|
1303
|
+
</p>
|
1304
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1305
|
+
<colgroup>
|
1306
|
+
<col align="left" valign="top">
|
1307
|
+
<col>
|
1308
|
+
</colgroup>
|
1309
|
+
<tbody><tr>
|
1310
|
+
<td><p><span class="term"><em class="parameter"><code>enable</code></em> :</span></p></td>
|
1311
|
+
<td>
|
1312
|
+
<code class="literal">TRUE</code> to enable per-actor motion events</td>
|
1313
|
+
</tr></tbody>
|
1314
|
+
</table></div>
|
1315
|
+
<p class="since">Since 0.6</p>
|
1316
|
+
</div>
|
1317
|
+
<hr>
|
1318
|
+
<div class="refsect2">
|
1319
|
+
<a name="clutter-get-motion-events-enabled"></a><h3>clutter_get_motion_events_enabled ()</h3>
|
1320
|
+
<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>
|
1321
|
+
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
|
1322
|
+
<h3 class="title">Warning</h3>
|
1323
|
+
<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>
|
1324
|
+
</div>
|
1325
|
+
<p>
|
1326
|
+
Gets whether the per-actor motion events are enabled.
|
1327
|
+
</p>
|
1328
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1329
|
+
<colgroup>
|
1330
|
+
<col align="left" valign="top">
|
1331
|
+
<col>
|
1332
|
+
</colgroup>
|
1333
|
+
<tbody><tr>
|
1334
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1335
|
+
<td>
|
1336
|
+
<code class="literal">TRUE</code> if the motion events are enabled</td>
|
1337
|
+
</tr></tbody>
|
1338
|
+
</table></div>
|
1339
|
+
<p class="since">Since 0.6</p>
|
1340
|
+
</div>
|
1341
|
+
<hr>
|
1342
|
+
<div class="refsect2">
|
1343
|
+
<a name="clutter-clear-glyph-cache"></a><h3>clutter_clear_glyph_cache ()</h3>
|
1344
|
+
<pre class="programlisting"><span class="returnvalue">void</span> clutter_clear_glyph_cache (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
1345
|
+
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
|
1346
|
+
<h3 class="title">Warning</h3>
|
1347
|
+
<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
|
1348
|
+
<code class="function">cogl_pango_font_map_clear_glyph_cache()</code> instead.</p>
|
1349
|
+
</div>
|
1350
|
+
<p>
|
1351
|
+
Clears the internal cache of glyphs used by the Pango
|
1352
|
+
renderer. This will free up some memory and GL texture
|
1353
|
+
resources. The cache will be automatically refilled as more text is
|
1354
|
+
drawn.
|
1355
|
+
</p>
|
1356
|
+
<p class="since">Since 0.8</p>
|
1357
|
+
</div>
|
1358
|
+
<hr>
|
1359
|
+
<div class="refsect2">
|
1360
|
+
<a name="ClutterFontFlags"></a><h3>enum ClutterFontFlags</h3>
|
1361
|
+
<pre class="programlisting">typedef enum {
|
1362
|
+
/*< prefix=CLUTTER_FONT >*/
|
1363
|
+
CLUTTER_FONT_MIPMAPPING = (1 << 0),
|
1364
|
+
CLUTTER_FONT_HINTING = (1 << 1)
|
1365
|
+
} ClutterFontFlags;
|
1366
|
+
</pre>
|
1367
|
+
<p>
|
1368
|
+
Runtime flags to change the font quality. To be used with
|
1369
|
+
<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>.
|
1370
|
+
</p>
|
1371
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1372
|
+
<colgroup>
|
1373
|
+
<col align="left" valign="top">
|
1374
|
+
<col>
|
1375
|
+
</colgroup>
|
1376
|
+
<tbody>
|
1377
|
+
<tr>
|
1378
|
+
<td><p><a name="CLUTTER-FONT-MIPMAPPING:CAPS"></a><span class="term"><code class="literal">CLUTTER_FONT_MIPMAPPING</code></span></p></td>
|
1379
|
+
<td>Set to use mipmaps for the glyph cache textures.
|
1380
|
+
</td>
|
1381
|
+
</tr>
|
1382
|
+
<tr>
|
1383
|
+
<td><p><a name="CLUTTER-FONT-HINTING:CAPS"></a><span class="term"><code class="literal">CLUTTER_FONT_HINTING</code></span></p></td>
|
1384
|
+
<td>Set to enable hinting on the glyphs.
|
1385
|
+
</td>
|
1386
|
+
</tr>
|
1387
|
+
</tbody>
|
1388
|
+
</table></div>
|
1389
|
+
<p class="since">Since 1.0</p>
|
1390
|
+
</div>
|
1391
|
+
<hr>
|
1392
|
+
<div class="refsect2">
|
1393
|
+
<a name="clutter-set-font-flags"></a><h3>clutter_set_font_flags ()</h3>
|
1394
|
+
<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>
|
1395
|
+
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
|
1396
|
+
<h3 class="title">Warning</h3>
|
1397
|
+
<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
|
1398
|
+
<span class="type">cairo_font_option_t</span> API.</p>
|
1399
|
+
</div>
|
1400
|
+
<p>
|
1401
|
+
Sets the font quality options for subsequent text rendering
|
1402
|
+
operations.
|
1403
|
+
</p>
|
1404
|
+
<p>
|
1405
|
+
Using mipmapped textures will improve the quality for scaled down
|
1406
|
+
text but will use more texture memory.
|
1407
|
+
</p>
|
1408
|
+
<p>
|
1409
|
+
Enabling hinting improves text quality for static text but may
|
1410
|
+
introduce some artifacts if the text is animated.
|
1411
|
+
</p>
|
1412
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1413
|
+
<colgroup>
|
1414
|
+
<col align="left" valign="top">
|
1415
|
+
<col>
|
1416
|
+
</colgroup>
|
1417
|
+
<tbody><tr>
|
1418
|
+
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
|
1419
|
+
<td>The new flags</td>
|
1420
|
+
</tr></tbody>
|
1421
|
+
</table></div>
|
1422
|
+
<p class="since">Since 1.0</p>
|
1423
|
+
</div>
|
1424
|
+
<hr>
|
1425
|
+
<div class="refsect2">
|
1426
|
+
<a name="clutter-get-font-flags"></a><h3>clutter_get_font_flags ()</h3>
|
1427
|
+
<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>
|
1428
|
+
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
|
1429
|
+
<h3 class="title">Warning</h3>
|
1430
|
+
<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
|
1431
|
+
<a href="/home/ebassi/gnome/install/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>
|
1432
|
+
</div>
|
1433
|
+
<p>
|
1434
|
+
Gets the current font flags for rendering text. See
|
1435
|
+
<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>.
|
1436
|
+
</p>
|
1437
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1438
|
+
<colgroup>
|
1439
|
+
<col align="left" valign="top">
|
1440
|
+
<col>
|
1441
|
+
</colgroup>
|
1442
|
+
<tbody><tr>
|
1443
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1444
|
+
<td>The font flags</td>
|
1445
|
+
</tr></tbody>
|
1446
|
+
</table></div>
|
1447
|
+
<p class="since">Since 1.0</p>
|
1448
|
+
</div>
|
1449
|
+
<hr>
|
1450
|
+
<div class="refsect2">
|
1451
|
+
<a name="clutter-get-font-map"></a><h3>clutter_get_font_map ()</h3>
|
1452
|
+
<pre class="programlisting"><span class="returnvalue">PangoFontMap</span> * clutter_get_font_map (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
1453
|
+
<p>
|
1454
|
+
Retrieves the <span class="type">PangoFontMap</span> instance used by Clutter.
|
1455
|
+
You can use the global font map object with the COGL
|
1456
|
+
Pango API.
|
1457
|
+
</p>
|
1458
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1459
|
+
<colgroup>
|
1460
|
+
<col align="left" valign="top">
|
1461
|
+
<col>
|
1462
|
+
</colgroup>
|
1463
|
+
<tbody><tr>
|
1464
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1465
|
+
<td>the <span class="type">PangoFontMap</span> instance. The returned
|
1466
|
+
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>
|
1467
|
+
</td>
|
1468
|
+
</tr></tbody>
|
1469
|
+
</table></div>
|
1470
|
+
<p class="since">Since 1.0</p>
|
1471
|
+
</div>
|
1472
|
+
<hr>
|
1473
|
+
<div class="refsect2">
|
1474
|
+
<a name="ClutterTextDirection"></a><h3>enum ClutterTextDirection</h3>
|
1475
|
+
<pre class="programlisting">typedef enum {
|
1476
|
+
CLUTTER_TEXT_DIRECTION_DEFAULT,
|
1477
|
+
CLUTTER_TEXT_DIRECTION_LTR,
|
1478
|
+
CLUTTER_TEXT_DIRECTION_RTL
|
1479
|
+
} ClutterTextDirection;
|
1480
|
+
</pre>
|
1481
|
+
<p>
|
1482
|
+
The text direction to be used by <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>s
|
1483
|
+
</p>
|
1484
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1485
|
+
<colgroup>
|
1486
|
+
<col align="left" valign="top">
|
1487
|
+
<col>
|
1488
|
+
</colgroup>
|
1489
|
+
<tbody>
|
1490
|
+
<tr>
|
1491
|
+
<td><p><a name="CLUTTER-TEXT-DIRECTION-DEFAULT:CAPS"></a><span class="term"><code class="literal">CLUTTER_TEXT_DIRECTION_DEFAULT</code></span></p></td>
|
1492
|
+
<td>Use the default setting, as returned
|
1493
|
+
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>
|
1494
|
+
</td>
|
1495
|
+
</tr>
|
1496
|
+
<tr>
|
1497
|
+
<td><p><a name="CLUTTER-TEXT-DIRECTION-LTR:CAPS"></a><span class="term"><code class="literal">CLUTTER_TEXT_DIRECTION_LTR</code></span></p></td>
|
1498
|
+
<td>Use left-to-right text direction
|
1499
|
+
</td>
|
1500
|
+
</tr>
|
1501
|
+
<tr>
|
1502
|
+
<td><p><a name="CLUTTER-TEXT-DIRECTION-RTL:CAPS"></a><span class="term"><code class="literal">CLUTTER_TEXT_DIRECTION_RTL</code></span></p></td>
|
1503
|
+
<td>Use right-to-left text direction
|
1504
|
+
</td>
|
1505
|
+
</tr>
|
1506
|
+
</tbody>
|
1507
|
+
</table></div>
|
1508
|
+
<p class="since">Since 1.2</p>
|
1509
|
+
</div>
|
1510
|
+
<hr>
|
1511
|
+
<div class="refsect2">
|
1512
|
+
<a name="clutter-get-default-text-direction"></a><h3>clutter_get_default_text_direction ()</h3>
|
1513
|
+
<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>
|
1514
|
+
<p>
|
1515
|
+
Retrieves the default direction for the text. The text direction is
|
1516
|
+
determined by the locale and/or by the <code class="varname">CLUTTER_TEXT_DIRECTION</code>
|
1517
|
+
environment variable.
|
1518
|
+
</p>
|
1519
|
+
<p>
|
1520
|
+
The default text direction can be overridden on a per-actor basis by using
|
1521
|
+
<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>.
|
1522
|
+
</p>
|
1523
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1524
|
+
<colgroup>
|
1525
|
+
<col align="left" valign="top">
|
1526
|
+
<col>
|
1527
|
+
</colgroup>
|
1528
|
+
<tbody><tr>
|
1529
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1530
|
+
<td>the default text direction</td>
|
1531
|
+
</tr></tbody>
|
1532
|
+
</table></div>
|
1533
|
+
<p class="since">Since 1.2</p>
|
1534
|
+
</div>
|
1535
|
+
<hr>
|
1536
|
+
<div class="refsect2">
|
1537
|
+
<a name="clutter-get-accessibility-enabled"></a><h3>clutter_get_accessibility_enabled ()</h3>
|
1538
|
+
<pre class="programlisting"><span class="returnvalue">gboolean</span> clutter_get_accessibility_enabled (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
1539
|
+
<p>
|
1540
|
+
Returns whether Clutter has accessibility support enabled. As
|
1541
|
+
least, a value of TRUE means that there are a proper AtkUtil
|
1542
|
+
implementation available
|
1543
|
+
</p>
|
1544
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1545
|
+
<colgroup>
|
1546
|
+
<col align="left" valign="top">
|
1547
|
+
<col>
|
1548
|
+
</colgroup>
|
1549
|
+
<tbody><tr>
|
1550
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1551
|
+
<td>
|
1552
|
+
<code class="literal">TRUE</code> if Clutter has accessibility support enabled</td>
|
1553
|
+
</tr></tbody>
|
1554
|
+
</table></div>
|
1555
|
+
<p class="since">Since 1.4</p>
|
1556
|
+
</div>
|
1557
|
+
<hr>
|
1558
|
+
<div class="refsect2">
|
1559
|
+
<a name="clutter-disable-accessibility"></a><h3>clutter_disable_accessibility ()</h3>
|
1560
|
+
<pre class="programlisting"><span class="returnvalue">void</span> clutter_disable_accessibility (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
1561
|
+
<p>
|
1562
|
+
Disable loading the accessibility support. It has the same effect
|
1563
|
+
as setting the environment variable
|
1564
|
+
CLUTTER_DISABLE_ACCESSIBILITY. For the same reason, this method
|
1565
|
+
should be called before <a class="link" href="clutter-General.html#clutter-init" title="clutter_init ()"><code class="function">clutter_init()</code></a>.
|
1566
|
+
</p>
|
1567
|
+
<p class="since">Since 1.14</p>
|
1568
|
+
</div>
|
1569
|
+
<hr>
|
1570
|
+
<div class="refsect2">
|
1571
|
+
<a name="clutter-threads-set-lock-functions"></a><h3>clutter_threads_set_lock_functions ()</h3>
|
1572
|
+
<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>,
|
1573
|
+
<em class="parameter"><code><span class="type">GCallback</span> leave_fn</code></em>);</pre>
|
1574
|
+
<p>
|
1575
|
+
Allows the application to replace the standard method that
|
1576
|
+
Clutter uses to protect its data structures. Normally, Clutter
|
1577
|
+
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>,
|
1578
|
+
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
|
1579
|
+
application provides, instead, a function <em class="parameter"><code>enter_fn</code></em> that is
|
1580
|
+
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
|
1581
|
+
called by <a class="link" href="clutter-General.html#clutter-threads-leave" title="clutter_threads_leave ()"><code class="function">clutter_threads_leave()</code></a>.
|
1582
|
+
</p>
|
1583
|
+
<p>
|
1584
|
+
The functions must provide at least same locking functionality
|
1585
|
+
as the default implementation, but can also do extra application
|
1586
|
+
specific processing.
|
1587
|
+
</p>
|
1588
|
+
<p>
|
1589
|
+
As an example, consider an application that has its own recursive
|
1590
|
+
lock that when held, holds the Clutter lock as well. When Clutter
|
1591
|
+
unlocks the Clutter lock when entering a recursive main loop, the
|
1592
|
+
application must temporarily release its lock as well.
|
1593
|
+
</p>
|
1594
|
+
<p>
|
1595
|
+
Most threaded Clutter apps won't need to use this method.
|
1596
|
+
</p>
|
1597
|
+
<p>
|
1598
|
+
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
|
1599
|
+
be called multiple times.
|
1600
|
+
</p>
|
1601
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1602
|
+
<colgroup>
|
1603
|
+
<col align="left" valign="top">
|
1604
|
+
<col>
|
1605
|
+
</colgroup>
|
1606
|
+
<tbody>
|
1607
|
+
<tr>
|
1608
|
+
<td><p><span class="term"><em class="parameter"><code>enter_fn</code></em> :</span></p></td>
|
1609
|
+
<td>function called when aquiring the Clutter main lock</td>
|
1610
|
+
</tr>
|
1611
|
+
<tr>
|
1612
|
+
<td><p><span class="term"><em class="parameter"><code>leave_fn</code></em> :</span></p></td>
|
1613
|
+
<td>function called when releasing the Clutter main lock</td>
|
1614
|
+
</tr>
|
1615
|
+
</tbody>
|
1616
|
+
</table></div>
|
1617
|
+
<p class="since">Since 0.4</p>
|
1618
|
+
</div>
|
1619
|
+
<hr>
|
1620
|
+
<div class="refsect2">
|
1621
|
+
<a name="clutter-threads-init"></a><h3>clutter_threads_init ()</h3>
|
1622
|
+
<pre class="programlisting"><span class="returnvalue">void</span> clutter_threads_init (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
1623
|
+
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
|
1624
|
+
<h3 class="title">Warning</h3>
|
1625
|
+
<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
|
1626
|
+
is initialized when Clutter is initialized.</p>
|
1627
|
+
</div>
|
1628
|
+
<p>
|
1629
|
+
Initialises the Clutter threading mechanism, so that Clutter API can be
|
1630
|
+
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
|
1631
|
+
<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.
|
1632
|
+
</p>
|
1633
|
+
<p>
|
1634
|
+
You must call <code class="function">g_thread_init()</code> before this function.
|
1635
|
+
</p>
|
1636
|
+
<p>
|
1637
|
+
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>.
|
1638
|
+
</p>
|
1639
|
+
<p>
|
1640
|
+
It is safe to call this function multiple times.
|
1641
|
+
</p>
|
1642
|
+
<p class="since">Since 0.4</p>
|
1643
|
+
</div>
|
1644
|
+
<hr>
|
1645
|
+
<div class="refsect2">
|
1646
|
+
<a name="clutter-threads-enter"></a><h3>clutter_threads_enter ()</h3>
|
1647
|
+
<pre class="programlisting"><span class="returnvalue">void</span> clutter_threads_enter (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
1648
|
+
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
|
1649
|
+
<h3 class="title">Warning</h3>
|
1650
|
+
<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
|
1651
|
+
code; marking critical sections is not portable on various
|
1652
|
+
platforms. Instead of acquiring the Clutter lock, schedule UI
|
1653
|
+
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
|
1654
|
+
<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>
|
1655
|
+
</div>
|
1656
|
+
<p>
|
1657
|
+
Locks the Clutter thread lock.
|
1658
|
+
</p>
|
1659
|
+
<p class="since">Since 0.4</p>
|
1660
|
+
</div>
|
1661
|
+
<hr>
|
1662
|
+
<div class="refsect2">
|
1663
|
+
<a name="clutter-threads-leave"></a><h3>clutter_threads_leave ()</h3>
|
1664
|
+
<pre class="programlisting"><span class="returnvalue">void</span> clutter_threads_leave (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
1665
|
+
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
|
1666
|
+
<h3 class="title">Warning</h3>
|
1667
|
+
<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
|
1668
|
+
code; marking critical sections is not portable on various
|
1669
|
+
platforms. Instead of acquiring the Clutter lock, schedule UI
|
1670
|
+
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
|
1671
|
+
<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>
|
1672
|
+
</div>
|
1673
|
+
<p>
|
1674
|
+
Unlocks the Clutter thread lock.
|
1675
|
+
</p>
|
1676
|
+
<p class="since">Since 0.4</p>
|
1677
|
+
</div>
|
1678
|
+
<hr>
|
1679
|
+
<div class="refsect2">
|
1680
|
+
<a name="clutter-threads-add-idle"></a><h3>clutter_threads_add_idle ()</h3>
|
1681
|
+
<pre class="programlisting"><span class="returnvalue">guint</span> clutter_threads_add_idle (<em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
|
1682
|
+
<em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
|
1683
|
+
<p>
|
1684
|
+
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
|
1685
|
+
default priority.
|
1686
|
+
</p>
|
1687
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1688
|
+
<colgroup>
|
1689
|
+
<col align="left" valign="top">
|
1690
|
+
<col>
|
1691
|
+
</colgroup>
|
1692
|
+
<tbody>
|
1693
|
+
<tr>
|
1694
|
+
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
|
1695
|
+
<td>function to call</td>
|
1696
|
+
</tr>
|
1697
|
+
<tr>
|
1698
|
+
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
|
1699
|
+
<td>data to pass to the function</td>
|
1700
|
+
</tr>
|
1701
|
+
<tr>
|
1702
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1703
|
+
<td>the ID (greater than 0) of the event source.</td>
|
1704
|
+
</tr>
|
1705
|
+
</tbody>
|
1706
|
+
</table></div>
|
1707
|
+
<p class="since">Since 0.4</p>
|
1708
|
+
</div>
|
1709
|
+
<hr>
|
1710
|
+
<div class="refsect2">
|
1711
|
+
<a name="clutter-threads-add-idle-full"></a><h3>clutter_threads_add_idle_full ()</h3>
|
1712
|
+
<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>,
|
1713
|
+
<em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
|
1714
|
+
<em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
|
1715
|
+
<em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);</pre>
|
1716
|
+
<p>
|
1717
|
+
Adds a function to be called whenever there are no higher priority
|
1718
|
+
events pending. If the function returns <code class="literal">FALSE</code> it is automatically
|
1719
|
+
removed from the list of event sources and will not be called again.
|
1720
|
+
</p>
|
1721
|
+
<p>
|
1722
|
+
This function can be considered a thread-safe variant of <code class="function">g_idle_add_full()</code>:
|
1723
|
+
it will call <em class="parameter"><code>function</code></em> while holding the Clutter lock. It is logically
|
1724
|
+
equivalent to the following implementation:
|
1725
|
+
</p>
|
1726
|
+
<p>
|
1727
|
+
</p>
|
1728
|
+
<div class="informalexample">
|
1729
|
+
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
1730
|
+
<tbody>
|
1731
|
+
<tr>
|
1732
|
+
<td class="listing_lines" align="right"><pre>1
|
1733
|
+
2
|
1734
|
+
3
|
1735
|
+
4
|
1736
|
+
5
|
1737
|
+
6
|
1738
|
+
7
|
1739
|
+
8
|
1740
|
+
9
|
1741
|
+
10
|
1742
|
+
11
|
1743
|
+
12
|
1744
|
+
13
|
1745
|
+
14
|
1746
|
+
15
|
1747
|
+
16
|
1748
|
+
17
|
1749
|
+
18
|
1750
|
+
19
|
1751
|
+
20
|
1752
|
+
21
|
1753
|
+
22
|
1754
|
+
23
|
1755
|
+
24
|
1756
|
+
25
|
1757
|
+
26
|
1758
|
+
27
|
1759
|
+
28
|
1760
|
+
29
|
1761
|
+
30
|
1762
|
+
31
|
1763
|
+
32
|
1764
|
+
33</pre></td>
|
1765
|
+
<td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> gboolean</span>
|
1766
|
+
<span class="function">idle_safe_callback</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">)</span>
|
1767
|
+
<span class="cbracket">{</span>
|
1768
|
+
<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>
|
1769
|
+
<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>
|
1770
|
+
|
1771
|
+
<span class="normal"> </span><span class="comment">/* mark the critical section */</span>
|
1772
|
+
|
1773
|
+
<span class="normal"> </span><span class="function"><a href="clutter-General.html#clutter-threads-enter">clutter_threads_enter</a></span><span class="symbol">();</span>
|
1774
|
+
|
1775
|
+
<span class="normal"> </span><span class="comment">/* the callback does not need to acquire the Clutter</span>
|
1776
|
+
<span class="comment"> * lock itself, as it is held by the this proxy handler</span>
|
1777
|
+
<span class="comment"> */</span>
|
1778
|
+
<span class="normal"> res </span><span class="symbol">=</span><span class="normal"> closure</span><span class="symbol">-></span><span class="function">callback</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>
|
1779
|
+
|
1780
|
+
<span class="normal"> </span><span class="function"><a href="clutter-General.html#clutter-threads-leave">clutter_threads_leave</a></span><span class="symbol">();</span>
|
1781
|
+
|
1782
|
+
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> res</span><span class="symbol">;</span>
|
1783
|
+
<span class="cbracket">}</span>
|
1784
|
+
<span class="keyword">static</span><span class="normal"> gulong</span>
|
1785
|
+
<span class="function">add_safe_idle</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GSourceFunc</span><span class="normal"> callback</span><span class="symbol">,</span>
|
1786
|
+
<span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">)</span>
|
1787
|
+
<span class="cbracket">{</span>
|
1788
|
+
<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"> </span><span class="function">g_new0</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">SafeClosure</span><span class="symbol">,</span><span class="normal"> </span><span class="number">1</span><span class="symbol">);</span>
|
1789
|
+
|
1790
|
+
<span class="normal"> closure</span><span class="symbol">-></span><span class="normal">callback </span><span class="symbol">=</span><span class="normal"> callback</span><span class="symbol">;</span>
|
1791
|
+
<span class="normal"> closure</span><span class="symbol">-></span><span class="normal">data </span><span class="symbol">=</span><span class="normal"> data</span><span class="symbol">;</span>
|
1792
|
+
|
1793
|
+
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> </span><span class="function">g_idle_add_full</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">G_PRIORITY_DEFAULT_IDLE</span><span class="symbol">,</span>
|
1794
|
+
<span class="normal"> idle_safe_callback</span><span class="symbol">,</span>
|
1795
|
+
<span class="normal"> closure</span><span class="symbol">,</span>
|
1796
|
+
<span class="normal"> g_free</span><span class="symbol">)</span>
|
1797
|
+
<span class="cbracket">}</span></pre></td>
|
1798
|
+
</tr>
|
1799
|
+
</tbody>
|
1800
|
+
</table>
|
1801
|
+
</div>
|
1802
|
+
|
1803
|
+
<p>
|
1804
|
+
</p>
|
1805
|
+
<p>
|
1806
|
+
This function should be used by threaded applications to make sure
|
1807
|
+
that <em class="parameter"><code>func</code></em> is emitted under the Clutter threads lock and invoked
|
1808
|
+
from the same thread that started the Clutter main loop. For instance,
|
1809
|
+
it can be used to update the UI using the results from a worker
|
1810
|
+
thread:
|
1811
|
+
</p>
|
1812
|
+
<p>
|
1813
|
+
</p>
|
1814
|
+
<div class="informalexample">
|
1815
|
+
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
1816
|
+
<tbody>
|
1817
|
+
<tr>
|
1818
|
+
<td class="listing_lines" align="right"><pre>1
|
1819
|
+
2
|
1820
|
+
3
|
1821
|
+
4
|
1822
|
+
5
|
1823
|
+
6
|
1824
|
+
7
|
1825
|
+
8
|
1826
|
+
9
|
1827
|
+
10
|
1828
|
+
11
|
1829
|
+
12
|
1830
|
+
13
|
1831
|
+
14
|
1832
|
+
15
|
1833
|
+
16
|
1834
|
+
17
|
1835
|
+
18
|
1836
|
+
19
|
1837
|
+
20
|
1838
|
+
21
|
1839
|
+
22
|
1840
|
+
23
|
1841
|
+
24
|
1842
|
+
25
|
1843
|
+
26
|
1844
|
+
27
|
1845
|
+
28</pre></td>
|
1846
|
+
<td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> gboolean</span>
|
1847
|
+
<span class="function">update_ui</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">)</span>
|
1848
|
+
<span class="cbracket">{</span>
|
1849
|
+
<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>
|
1850
|
+
|
1851
|
+
<span class="normal"> </span><span class="comment">/* it is safe to call Clutter API from this function because</span>
|
1852
|
+
<span class="comment"> * it is invoked from the same thread that started the main</span>
|
1853
|
+
<span class="comment"> * loop and under the Clutter thread lock</span>
|
1854
|
+
<span class="comment"> */</span>
|
1855
|
+
<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">-></span><span class="normal">label</span><span class="symbol">),</span>
|
1856
|
+
<span class="normal"> closure</span><span class="symbol">-></span><span class="normal">text</span><span class="symbol">);</span>
|
1857
|
+
|
1858
|
+
<span class="normal"> </span><span class="function">g_object_unref</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">closure</span><span class="symbol">-></span><span class="normal">label</span><span class="symbol">);</span>
|
1859
|
+
<span class="normal"> </span><span class="function">g_free</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">closure</span><span class="symbol">);</span>
|
1860
|
+
|
1861
|
+
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> FALSE</span><span class="symbol">;</span>
|
1862
|
+
<span class="cbracket">}</span>
|
1863
|
+
|
1864
|
+
<span class="normal"> </span><span class="comment">/* within another thread */</span>
|
1865
|
+
<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>
|
1866
|
+
<span class="normal"> </span><span class="comment">/* always take a reference on GObject instances */</span>
|
1867
|
+
<span class="normal"> closure</span><span class="symbol">-></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">-></span><span class="normal">label</span><span class="symbol">);</span>
|
1868
|
+
<span class="normal"> closure</span><span class="symbol">-></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>
|
1869
|
+
|
1870
|
+
<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_IDLE</span><span class="symbol">,</span>
|
1871
|
+
<span class="normal"> update_ui</span><span class="symbol">,</span>
|
1872
|
+
<span class="normal"> closure</span><span class="symbol">,</span>
|
1873
|
+
<span class="normal"> NULL</span><span class="symbol">);</span></pre></td>
|
1874
|
+
</tr>
|
1875
|
+
</tbody>
|
1876
|
+
</table>
|
1877
|
+
</div>
|
1878
|
+
|
1879
|
+
<p>
|
1880
|
+
</p>
|
1881
|
+
<p>
|
1882
|
+
Rename to: clutter_threads_add_idle
|
1883
|
+
</p>
|
1884
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1885
|
+
<colgroup>
|
1886
|
+
<col align="left" valign="top">
|
1887
|
+
<col>
|
1888
|
+
</colgroup>
|
1889
|
+
<tbody>
|
1890
|
+
<tr>
|
1891
|
+
<td><p><span class="term"><em class="parameter"><code>priority</code></em> :</span></p></td>
|
1892
|
+
<td>the priority of the timeout source. Typically this will be in the
|
1893
|
+
range between <span class="type">G_PRIORITY_DEFAULT_IDLE</span> and <span class="type">G_PRIORITY_HIGH_IDLE</span>
|
1894
|
+
</td>
|
1895
|
+
</tr>
|
1896
|
+
<tr>
|
1897
|
+
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
|
1898
|
+
<td>function to call</td>
|
1899
|
+
</tr>
|
1900
|
+
<tr>
|
1901
|
+
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
|
1902
|
+
<td>data to pass to the function</td>
|
1903
|
+
</tr>
|
1904
|
+
<tr>
|
1905
|
+
<td><p><span class="term"><em class="parameter"><code>notify</code></em> :</span></p></td>
|
1906
|
+
<td>functio to call when the idle source is removed</td>
|
1907
|
+
</tr>
|
1908
|
+
<tr>
|
1909
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1910
|
+
<td>the ID (greater than 0) of the event source.</td>
|
1911
|
+
</tr>
|
1912
|
+
</tbody>
|
1913
|
+
</table></div>
|
1914
|
+
<p class="since">Since 0.4</p>
|
1915
|
+
</div>
|
1916
|
+
<hr>
|
1917
|
+
<div class="refsect2">
|
1918
|
+
<a name="clutter-threads-add-timeout"></a><h3>clutter_threads_add_timeout ()</h3>
|
1919
|
+
<pre class="programlisting"><span class="returnvalue">guint</span> clutter_threads_add_timeout (<em class="parameter"><code><span class="type">guint</span> interval</code></em>,
|
1920
|
+
<em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
|
1921
|
+
<em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
|
1922
|
+
<p>
|
1923
|
+
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>.
|
1924
|
+
</p>
|
1925
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1926
|
+
<colgroup>
|
1927
|
+
<col align="left" valign="top">
|
1928
|
+
<col>
|
1929
|
+
</colgroup>
|
1930
|
+
<tbody>
|
1931
|
+
<tr>
|
1932
|
+
<td><p><span class="term"><em class="parameter"><code>interval</code></em> :</span></p></td>
|
1933
|
+
<td>the time between calls to the function, in milliseconds</td>
|
1934
|
+
</tr>
|
1935
|
+
<tr>
|
1936
|
+
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
|
1937
|
+
<td>function to call</td>
|
1938
|
+
</tr>
|
1939
|
+
<tr>
|
1940
|
+
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
|
1941
|
+
<td>data to pass to the function</td>
|
1942
|
+
</tr>
|
1943
|
+
<tr>
|
1944
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1945
|
+
<td>the ID (greater than 0) of the event source.</td>
|
1946
|
+
</tr>
|
1947
|
+
</tbody>
|
1948
|
+
</table></div>
|
1949
|
+
<p class="since">Since 0.4</p>
|
1950
|
+
</div>
|
1951
|
+
<hr>
|
1952
|
+
<div class="refsect2">
|
1953
|
+
<a name="clutter-threads-add-timeout-full"></a><h3>clutter_threads_add_timeout_full ()</h3>
|
1954
|
+
<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>,
|
1955
|
+
<em class="parameter"><code><span class="type">guint</span> interval</code></em>,
|
1956
|
+
<em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
|
1957
|
+
<em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
|
1958
|
+
<em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);</pre>
|
1959
|
+
<p>
|
1960
|
+
Sets a function to be called at regular intervals holding the Clutter
|
1961
|
+
threads lock, with the given priority. The function is called repeatedly
|
1962
|
+
until it returns <code class="literal">FALSE</code>, at which point the timeout is automatically
|
1963
|
+
removed and the function will not be called again. The <em class="parameter"><code>notify</code></em> function
|
1964
|
+
is called when the timeout is removed.
|
1965
|
+
</p>
|
1966
|
+
<p>
|
1967
|
+
The first call to the function will be at the end of the first <em class="parameter"><code>interval</code></em>.
|
1968
|
+
</p>
|
1969
|
+
<p>
|
1970
|
+
It is important to note that, due to how the Clutter main loop is
|
1971
|
+
implemented, the timing will not be accurate and it will not try to
|
1972
|
+
"keep up" with the interval.
|
1973
|
+
</p>
|
1974
|
+
<p>
|
1975
|
+
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>.
|
1976
|
+
</p>
|
1977
|
+
<p>
|
1978
|
+
Rename to: clutter_threads_add_timeout
|
1979
|
+
</p>
|
1980
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
1981
|
+
<colgroup>
|
1982
|
+
<col align="left" valign="top">
|
1983
|
+
<col>
|
1984
|
+
</colgroup>
|
1985
|
+
<tbody>
|
1986
|
+
<tr>
|
1987
|
+
<td><p><span class="term"><em class="parameter"><code>priority</code></em> :</span></p></td>
|
1988
|
+
<td>the priority of the timeout source. Typically this will be in the
|
1989
|
+
range between <span class="type">G_PRIORITY_DEFAULT</span> and <span class="type">G_PRIORITY_HIGH</span>.</td>
|
1990
|
+
</tr>
|
1991
|
+
<tr>
|
1992
|
+
<td><p><span class="term"><em class="parameter"><code>interval</code></em> :</span></p></td>
|
1993
|
+
<td>the time between calls to the function, in milliseconds</td>
|
1994
|
+
</tr>
|
1995
|
+
<tr>
|
1996
|
+
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
|
1997
|
+
<td>function to call</td>
|
1998
|
+
</tr>
|
1999
|
+
<tr>
|
2000
|
+
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
|
2001
|
+
<td>data to pass to the function</td>
|
2002
|
+
</tr>
|
2003
|
+
<tr>
|
2004
|
+
<td><p><span class="term"><em class="parameter"><code>notify</code></em> :</span></p></td>
|
2005
|
+
<td>function to call when the timeout source is removed</td>
|
2006
|
+
</tr>
|
2007
|
+
<tr>
|
2008
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
2009
|
+
<td>the ID (greater than 0) of the event source.</td>
|
2010
|
+
</tr>
|
2011
|
+
</tbody>
|
2012
|
+
</table></div>
|
2013
|
+
<p class="since">Since 0.4</p>
|
2014
|
+
</div>
|
2015
|
+
<hr>
|
2016
|
+
<div class="refsect2">
|
2017
|
+
<a name="clutter-threads-add-frame-source"></a><h3>clutter_threads_add_frame_source ()</h3>
|
2018
|
+
<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>,
|
2019
|
+
<em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
|
2020
|
+
<em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
|
2021
|
+
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
|
2022
|
+
<h3 class="title">Warning</h3>
|
2023
|
+
<p><code class="literal">clutter_threads_add_frame_source</code> is deprecated and should not be used in newly-written code. 1.6</p>
|
2024
|
+
</div>
|
2025
|
+
<p>
|
2026
|
+
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>.
|
2027
|
+
</p>
|
2028
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
2029
|
+
<colgroup>
|
2030
|
+
<col align="left" valign="top">
|
2031
|
+
<col>
|
2032
|
+
</colgroup>
|
2033
|
+
<tbody>
|
2034
|
+
<tr>
|
2035
|
+
<td><p><span class="term"><em class="parameter"><code>fps</code></em> :</span></p></td>
|
2036
|
+
<td>the number of times per second to call the function</td>
|
2037
|
+
</tr>
|
2038
|
+
<tr>
|
2039
|
+
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
|
2040
|
+
<td>function to call</td>
|
2041
|
+
</tr>
|
2042
|
+
<tr>
|
2043
|
+
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
|
2044
|
+
<td>data to pass to the function</td>
|
2045
|
+
</tr>
|
2046
|
+
<tr>
|
2047
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
2048
|
+
<td>the ID (greater than 0) of the event source.</td>
|
2049
|
+
</tr>
|
2050
|
+
</tbody>
|
2051
|
+
</table></div>
|
2052
|
+
<p class="since">Since 0.8</p>
|
2053
|
+
</div>
|
2054
|
+
<hr>
|
2055
|
+
<div class="refsect2">
|
2056
|
+
<a name="clutter-threads-add-frame-source-full"></a><h3>clutter_threads_add_frame_source_full ()</h3>
|
2057
|
+
<pre class="programlisting"><span class="returnvalue">guint</span> clutter_threads_add_frame_source_full
|
2058
|
+
(<em class="parameter"><code><span class="type">gint</span> priority</code></em>,
|
2059
|
+
<em class="parameter"><code><span class="type">guint</span> fps</code></em>,
|
2060
|
+
<em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
|
2061
|
+
<em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
|
2062
|
+
<em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);</pre>
|
2063
|
+
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
|
2064
|
+
<h3 class="title">Warning</h3>
|
2065
|
+
<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>
|
2066
|
+
</div>
|
2067
|
+
<p>
|
2068
|
+
Sets a function to be called at regular intervals holding the Clutter
|
2069
|
+
threads lock, with the given priority. The function is called repeatedly
|
2070
|
+
until it returns <code class="literal">FALSE</code>, at which point the timeout is automatically
|
2071
|
+
removed and the function will not be called again. The <em class="parameter"><code>notify</code></em> function
|
2072
|
+
is called when the timeout is removed.
|
2073
|
+
</p>
|
2074
|
+
<p>
|
2075
|
+
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>
|
2076
|
+
except that it will try to compensate for delays. For example, if
|
2077
|
+
<em class="parameter"><code>func</code></em> takes half the interval time to execute then the function
|
2078
|
+
will be called again half the interval time after it finished. In
|
2079
|
+
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
|
2080
|
+
full interval after the function completes so the delay between
|
2081
|
+
calls would be <em class="parameter"><code>interval</code></em> * 1.5. This function does not however try
|
2082
|
+
to invoke the function multiple times to catch up missing frames if
|
2083
|
+
<em class="parameter"><code>func</code></em> takes more than <em class="parameter"><code>interval</code></em> ms to execute.
|
2084
|
+
</p>
|
2085
|
+
<p>
|
2086
|
+
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>.
|
2087
|
+
</p>
|
2088
|
+
<p>
|
2089
|
+
Rename to: clutter_threads_add_frame_source
|
2090
|
+
</p>
|
2091
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
2092
|
+
<colgroup>
|
2093
|
+
<col align="left" valign="top">
|
2094
|
+
<col>
|
2095
|
+
</colgroup>
|
2096
|
+
<tbody>
|
2097
|
+
<tr>
|
2098
|
+
<td><p><span class="term"><em class="parameter"><code>priority</code></em> :</span></p></td>
|
2099
|
+
<td>the priority of the frame source. Typically this will be in the
|
2100
|
+
range between <code class="literal">G_PRIORITY_DEFAULT</code> and <code class="literal">G_PRIORITY_HIGH</code>.</td>
|
2101
|
+
</tr>
|
2102
|
+
<tr>
|
2103
|
+
<td><p><span class="term"><em class="parameter"><code>fps</code></em> :</span></p></td>
|
2104
|
+
<td>the number of times per second to call the function</td>
|
2105
|
+
</tr>
|
2106
|
+
<tr>
|
2107
|
+
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
|
2108
|
+
<td>function to call</td>
|
2109
|
+
</tr>
|
2110
|
+
<tr>
|
2111
|
+
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
|
2112
|
+
<td>data to pass to the function</td>
|
2113
|
+
</tr>
|
2114
|
+
<tr>
|
2115
|
+
<td><p><span class="term"><em class="parameter"><code>notify</code></em> :</span></p></td>
|
2116
|
+
<td>function to call when the timeout source is removed</td>
|
2117
|
+
</tr>
|
2118
|
+
<tr>
|
2119
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
2120
|
+
<td>the ID (greater than 0) of the event source.</td>
|
2121
|
+
</tr>
|
2122
|
+
</tbody>
|
2123
|
+
</table></div>
|
2124
|
+
<p class="since">Since 0.8</p>
|
2125
|
+
</div>
|
2126
|
+
<hr>
|
2127
|
+
<div class="refsect2">
|
2128
|
+
<a name="clutter-threads-add-repaint-func"></a><h3>clutter_threads_add_repaint_func ()</h3>
|
2129
|
+
<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>,
|
2130
|
+
<em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
|
2131
|
+
<em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);</pre>
|
2132
|
+
<p>
|
2133
|
+
Adds a function to be called whenever Clutter is processing a new
|
2134
|
+
frame.
|
2135
|
+
</p>
|
2136
|
+
<p>
|
2137
|
+
If the function returns <code class="literal">FALSE</code> it is automatically removed from the
|
2138
|
+
list of repaint functions and will not be called again.
|
2139
|
+
</p>
|
2140
|
+
<p>
|
2141
|
+
This function is guaranteed to be called from within the same thread
|
2142
|
+
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;
|
2143
|
+
the function will be called within the main loop, so it is imperative
|
2144
|
+
that it does not block, otherwise the frame time budget may be lost.
|
2145
|
+
</p>
|
2146
|
+
<p>
|
2147
|
+
A repaint function is useful to ensure that an update of the scenegraph
|
2148
|
+
is performed before the scenegraph is repainted; for instance, uploading
|
2149
|
+
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
|
2150
|
+
function added using this function will be invoked prior to the frame
|
2151
|
+
being processed.
|
2152
|
+
</p>
|
2153
|
+
<p>
|
2154
|
+
Adding a repaint function does not automatically ensure that a new
|
2155
|
+
frame will be queued.
|
2156
|
+
</p>
|
2157
|
+
<p>
|
2158
|
+
When the repaint function is removed (either because it returned <code class="literal">FALSE</code>
|
2159
|
+
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
|
2160
|
+
<em class="parameter"><code>notify</code></em> function will be called, if any is set.
|
2161
|
+
</p>
|
2162
|
+
<p>
|
2163
|
+
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>
|
2164
|
+
</p>
|
2165
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
2166
|
+
<colgroup>
|
2167
|
+
<col align="left" valign="top">
|
2168
|
+
<col>
|
2169
|
+
</colgroup>
|
2170
|
+
<tbody>
|
2171
|
+
<tr>
|
2172
|
+
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
|
2173
|
+
<td>the function to be called within the paint cycle</td>
|
2174
|
+
</tr>
|
2175
|
+
<tr>
|
2176
|
+
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
|
2177
|
+
<td>data to be passed to the function, or <code class="literal">NULL</code>
|
2178
|
+
</td>
|
2179
|
+
</tr>
|
2180
|
+
<tr>
|
2181
|
+
<td><p><span class="term"><em class="parameter"><code>notify</code></em> :</span></p></td>
|
2182
|
+
<td>function to be called when removing the repaint
|
2183
|
+
function, or <code class="literal">NULL</code>
|
2184
|
+
</td>
|
2185
|
+
</tr>
|
2186
|
+
<tr>
|
2187
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
2188
|
+
<td>the ID (greater than 0) of the repaint function. You
|
2189
|
+
can use the returned integer to remove the repaint function by
|
2190
|
+
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>
|
2191
|
+
</tr>
|
2192
|
+
</tbody>
|
2193
|
+
</table></div>
|
2194
|
+
<p class="since">Since 1.0</p>
|
2195
|
+
</div>
|
2196
|
+
<hr>
|
2197
|
+
<div class="refsect2">
|
2198
|
+
<a name="ClutterRepaintFlags"></a><h3>enum ClutterRepaintFlags</h3>
|
2199
|
+
<pre class="programlisting">typedef enum {
|
2200
|
+
CLUTTER_REPAINT_FLAGS_PRE_PAINT = 1 << 0,
|
2201
|
+
CLUTTER_REPAINT_FLAGS_POST_PAINT = 1 << 1,
|
2202
|
+
CLUTTER_REPAINT_FLAGS_QUEUE_REDRAW_ON_ADD = 1 << 2
|
2203
|
+
} ClutterRepaintFlags;
|
2204
|
+
</pre>
|
2205
|
+
<p>
|
2206
|
+
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>.
|
2207
|
+
</p>
|
2208
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
2209
|
+
<colgroup>
|
2210
|
+
<col align="left" valign="top">
|
2211
|
+
<col>
|
2212
|
+
</colgroup>
|
2213
|
+
<tbody>
|
2214
|
+
<tr>
|
2215
|
+
<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>
|
2216
|
+
<td>Run the repaint function prior to
|
2217
|
+
painting the stages
|
2218
|
+
</td>
|
2219
|
+
</tr>
|
2220
|
+
<tr>
|
2221
|
+
<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>
|
2222
|
+
<td>Run the repaint function after
|
2223
|
+
painting the stages
|
2224
|
+
</td>
|
2225
|
+
</tr>
|
2226
|
+
<tr>
|
2227
|
+
<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>
|
2228
|
+
<td>Ensure that a new frame
|
2229
|
+
is queued after adding the repaint function
|
2230
|
+
</td>
|
2231
|
+
</tr>
|
2232
|
+
</tbody>
|
2233
|
+
</table></div>
|
2234
|
+
<p class="since">Since 1.10</p>
|
2235
|
+
</div>
|
2236
|
+
<hr>
|
2237
|
+
<div class="refsect2">
|
2238
|
+
<a name="clutter-threads-add-repaint-func-full"></a><h3>clutter_threads_add_repaint_func_full ()</h3>
|
2239
|
+
<pre class="programlisting"><span class="returnvalue">guint</span> clutter_threads_add_repaint_func_full
|
2240
|
+
(<em class="parameter"><code><a class="link" href="clutter-General.html#ClutterRepaintFlags" title="enum ClutterRepaintFlags"><span class="type">ClutterRepaintFlags</span></a> flags</code></em>,
|
2241
|
+
<em class="parameter"><code><span class="type">GSourceFunc</span> func</code></em>,
|
2242
|
+
<em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
|
2243
|
+
<em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);</pre>
|
2244
|
+
<p>
|
2245
|
+
Adds a function to be called whenever Clutter is processing a new
|
2246
|
+
frame.
|
2247
|
+
</p>
|
2248
|
+
<p>
|
2249
|
+
If the function returns <code class="literal">FALSE</code> it is automatically removed from the
|
2250
|
+
list of repaint functions and will not be called again.
|
2251
|
+
</p>
|
2252
|
+
<p>
|
2253
|
+
This function is guaranteed to be called from within the same thread
|
2254
|
+
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;
|
2255
|
+
the function will be called within the main loop, so it is imperative
|
2256
|
+
that it does not block, otherwise the frame time budget may be lost.
|
2257
|
+
</p>
|
2258
|
+
<p>
|
2259
|
+
A repaint function is useful to ensure that an update of the scenegraph
|
2260
|
+
is performed before the scenegraph is repainted; for instance, uploading
|
2261
|
+
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
|
2262
|
+
function will determine the section of the frame processing that will
|
2263
|
+
result in <em class="parameter"><code>func</code></em> being called.
|
2264
|
+
</p>
|
2265
|
+
<p>
|
2266
|
+
Adding a repaint function does not automatically ensure that a new
|
2267
|
+
frame will be queued.
|
2268
|
+
</p>
|
2269
|
+
<p>
|
2270
|
+
When the repaint function is removed (either because it returned <code class="literal">FALSE</code>
|
2271
|
+
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
|
2272
|
+
<em class="parameter"><code>notify</code></em> function will be called, if any is set.
|
2273
|
+
</p>
|
2274
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
2275
|
+
<colgroup>
|
2276
|
+
<col align="left" valign="top">
|
2277
|
+
<col>
|
2278
|
+
</colgroup>
|
2279
|
+
<tbody>
|
2280
|
+
<tr>
|
2281
|
+
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
|
2282
|
+
<td>flags for the repaint function</td>
|
2283
|
+
</tr>
|
2284
|
+
<tr>
|
2285
|
+
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
|
2286
|
+
<td>the function to be called within the paint cycle</td>
|
2287
|
+
</tr>
|
2288
|
+
<tr>
|
2289
|
+
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
|
2290
|
+
<td>data to be passed to the function, or <code class="literal">NULL</code>
|
2291
|
+
</td>
|
2292
|
+
</tr>
|
2293
|
+
<tr>
|
2294
|
+
<td><p><span class="term"><em class="parameter"><code>notify</code></em> :</span></p></td>
|
2295
|
+
<td>function to be called when removing the repaint
|
2296
|
+
function, or <code class="literal">NULL</code>
|
2297
|
+
</td>
|
2298
|
+
</tr>
|
2299
|
+
<tr>
|
2300
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
2301
|
+
<td>the ID (greater than 0) of the repaint function. You
|
2302
|
+
can use the returned integer to remove the repaint function by
|
2303
|
+
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>
|
2304
|
+
</tr>
|
2305
|
+
</tbody>
|
2306
|
+
</table></div>
|
2307
|
+
<p class="since">Since 1.10</p>
|
2308
|
+
</div>
|
2309
|
+
<hr>
|
2310
|
+
<div class="refsect2">
|
2311
|
+
<a name="clutter-threads-remove-repaint-func"></a><h3>clutter_threads_remove_repaint_func ()</h3>
|
2312
|
+
<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>
|
2313
|
+
<p>
|
2314
|
+
Removes the repaint function with <em class="parameter"><code>handle_id</code></em> as its id
|
2315
|
+
</p>
|
2316
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
2317
|
+
<colgroup>
|
2318
|
+
<col align="left" valign="top">
|
2319
|
+
<col>
|
2320
|
+
</colgroup>
|
2321
|
+
<tbody><tr>
|
2322
|
+
<td><p><span class="term"><em class="parameter"><code>handle_id</code></em> :</span></p></td>
|
2323
|
+
<td>an unsigned integer greater than zero</td>
|
2324
|
+
</tr></tbody>
|
2325
|
+
</table></div>
|
2326
|
+
<p class="since">Since 1.0</p>
|
2327
|
+
</div>
|
2328
|
+
<hr>
|
2329
|
+
<div class="refsect2">
|
2330
|
+
<a name="clutter-get-keyboard-grab"></a><h3>clutter_get_keyboard_grab ()</h3>
|
2331
|
+
<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>
|
2332
|
+
<p>
|
2333
|
+
Queries the current keyboard grab of clutter.
|
2334
|
+
</p>
|
2335
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
2336
|
+
<colgroup>
|
2337
|
+
<col align="left" valign="top">
|
2338
|
+
<col>
|
2339
|
+
</colgroup>
|
2340
|
+
<tbody><tr>
|
2341
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
2342
|
+
<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>
|
2343
|
+
</td>
|
2344
|
+
</tr></tbody>
|
2345
|
+
</table></div>
|
2346
|
+
<p class="since">Since 0.6</p>
|
2347
|
+
</div>
|
2348
|
+
<hr>
|
2349
|
+
<div class="refsect2">
|
2350
|
+
<a name="clutter-get-pointer-grab"></a><h3>clutter_get_pointer_grab ()</h3>
|
2351
|
+
<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>
|
2352
|
+
<p>
|
2353
|
+
Queries the current pointer grab of clutter.
|
2354
|
+
</p>
|
2355
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
2356
|
+
<colgroup>
|
2357
|
+
<col align="left" valign="top">
|
2358
|
+
<col>
|
2359
|
+
</colgroup>
|
2360
|
+
<tbody><tr>
|
2361
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
2362
|
+
<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>
|
2363
|
+
</td>
|
2364
|
+
</tr></tbody>
|
2365
|
+
</table></div>
|
2366
|
+
<p class="since">Since 0.6</p>
|
2367
|
+
</div>
|
2368
|
+
<hr>
|
2369
|
+
<div class="refsect2">
|
2370
|
+
<a name="clutter-grab-keyboard"></a><h3>clutter_grab_keyboard ()</h3>
|
2371
|
+
<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>
|
2372
|
+
<p>
|
2373
|
+
Grabs keyboard events, after the grab is done keyboard
|
2374
|
+
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>)
|
2375
|
+
are delivered to this actor directly. The source set in the event will be
|
2376
|
+
the actor that would have received the event if the keyboard grab was not
|
2377
|
+
in effect.
|
2378
|
+
</p>
|
2379
|
+
<p>
|
2380
|
+
Like pointer grabs, keyboard grabs should only be used as a last
|
2381
|
+
resource.
|
2382
|
+
</p>
|
2383
|
+
<p>
|
2384
|
+
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>
|
2385
|
+
to perform a "soft" key grab and assign key focus to a specific actor.
|
2386
|
+
</p>
|
2387
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
2388
|
+
<colgroup>
|
2389
|
+
<col align="left" valign="top">
|
2390
|
+
<col>
|
2391
|
+
</colgroup>
|
2392
|
+
<tbody><tr>
|
2393
|
+
<td><p><span class="term"><em class="parameter"><code>actor</code></em> :</span></p></td>
|
2394
|
+
<td>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>
|
2395
|
+
</td>
|
2396
|
+
</tr></tbody>
|
2397
|
+
</table></div>
|
2398
|
+
<p class="since">Since 0.6</p>
|
2399
|
+
</div>
|
2400
|
+
<hr>
|
2401
|
+
<div class="refsect2">
|
2402
|
+
<a name="clutter-grab-pointer"></a><h3>clutter_grab_pointer ()</h3>
|
2403
|
+
<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>
|
2404
|
+
<p>
|
2405
|
+
Grabs pointer events, after the grab is done all pointer related events
|
2406
|
+
(press, motion, release, enter, leave and scroll) are delivered to this
|
2407
|
+
actor directly without passing through both capture and bubble phases of
|
2408
|
+
the event delivery chain. The source set in the event will be the actor
|
2409
|
+
that would have received the event if the pointer grab was not in effect.
|
2410
|
+
</p>
|
2411
|
+
<p>
|
2412
|
+
</p>
|
2413
|
+
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
|
2414
|
+
<h3 class="title">Note</h3>
|
2415
|
+
<p>Grabs completely override the entire event delivery chain
|
2416
|
+
done by Clutter. Pointer grabs should only be used as a last resource;
|
2417
|
+
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
|
2418
|
+
preferred way to intercept event delivery to reactive actors.</p>
|
2419
|
+
</div>
|
2420
|
+
<p>
|
2421
|
+
</p>
|
2422
|
+
<p>
|
2423
|
+
This function should rarely be used.
|
2424
|
+
</p>
|
2425
|
+
<p>
|
2426
|
+
If a grab is required, you are strongly encouraged to use a specific
|
2427
|
+
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>.
|
2428
|
+
</p>
|
2429
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
2430
|
+
<colgroup>
|
2431
|
+
<col align="left" valign="top">
|
2432
|
+
<col>
|
2433
|
+
</colgroup>
|
2434
|
+
<tbody><tr>
|
2435
|
+
<td><p><span class="term"><em class="parameter"><code>actor</code></em> :</span></p></td>
|
2436
|
+
<td>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>
|
2437
|
+
</td>
|
2438
|
+
</tr></tbody>
|
2439
|
+
</table></div>
|
2440
|
+
<p class="since">Since 0.6</p>
|
2441
|
+
</div>
|
2442
|
+
<hr>
|
2443
|
+
<div class="refsect2">
|
2444
|
+
<a name="clutter-ungrab-keyboard"></a><h3>clutter_ungrab_keyboard ()</h3>
|
2445
|
+
<pre class="programlisting"><span class="returnvalue">void</span> clutter_ungrab_keyboard (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
2446
|
+
<p>
|
2447
|
+
Removes an existing grab of the keyboard.
|
2448
|
+
</p>
|
2449
|
+
<p class="since">Since 0.6</p>
|
2450
|
+
</div>
|
2451
|
+
<hr>
|
2452
|
+
<div class="refsect2">
|
2453
|
+
<a name="clutter-ungrab-pointer"></a><h3>clutter_ungrab_pointer ()</h3>
|
2454
|
+
<pre class="programlisting"><span class="returnvalue">void</span> clutter_ungrab_pointer (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
2455
|
+
<p>
|
2456
|
+
Removes an existing grab of the pointer.
|
2457
|
+
</p>
|
2458
|
+
<p class="since">Since 0.6</p>
|
2459
|
+
</div>
|
2460
|
+
<hr>
|
2461
|
+
<div class="refsect2">
|
2462
|
+
<a name="clutter-grab-pointer-for-device"></a><h3>clutter_grab_pointer_for_device ()</h3>
|
2463
|
+
<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>,
|
2464
|
+
<em class="parameter"><code><span class="type">gint</span> id_</code></em>);</pre>
|
2465
|
+
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
|
2466
|
+
<h3 class="title">Warning</h3>
|
2467
|
+
<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>
|
2468
|
+
</div>
|
2469
|
+
<p>
|
2470
|
+
Grabs all the pointer events coming from the device <em class="parameter"><code>id</code></em> for <em class="parameter"><code>actor</code></em>.
|
2471
|
+
</p>
|
2472
|
+
<p>
|
2473
|
+
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>.
|
2474
|
+
</p>
|
2475
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
2476
|
+
<colgroup>
|
2477
|
+
<col align="left" valign="top">
|
2478
|
+
<col>
|
2479
|
+
</colgroup>
|
2480
|
+
<tbody>
|
2481
|
+
<tr>
|
2482
|
+
<td><p><span class="term"><em class="parameter"><code>actor</code></em> :</span></p></td>
|
2483
|
+
<td>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>
|
2484
|
+
</td>
|
2485
|
+
</tr>
|
2486
|
+
<tr>
|
2487
|
+
<td><p><span class="term"><em class="parameter"><code>id_</code></em> :</span></p></td>
|
2488
|
+
<td>a device id, or -1</td>
|
2489
|
+
</tr>
|
2490
|
+
</tbody>
|
2491
|
+
</table></div>
|
2492
|
+
<p class="since">Since 0.8</p>
|
2493
|
+
</div>
|
2494
|
+
<hr>
|
2495
|
+
<div class="refsect2">
|
2496
|
+
<a name="clutter-ungrab-pointer-for-device"></a><h3>clutter_ungrab_pointer_for_device ()</h3>
|
2497
|
+
<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>
|
2498
|
+
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
|
2499
|
+
<h3 class="title">Warning</h3>
|
2500
|
+
<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>
|
2501
|
+
</div>
|
2502
|
+
<p>
|
2503
|
+
Removes an existing grab of the pointer events for device <em class="parameter"><code>id_</code></em>.
|
2504
|
+
</p>
|
2505
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
2506
|
+
<colgroup>
|
2507
|
+
<col align="left" valign="top">
|
2508
|
+
<col>
|
2509
|
+
</colgroup>
|
2510
|
+
<tbody><tr>
|
2511
|
+
<td><p><span class="term"><em class="parameter"><code>id_</code></em> :</span></p></td>
|
2512
|
+
<td>a device id</td>
|
2513
|
+
</tr></tbody>
|
2514
|
+
</table></div>
|
2515
|
+
<p class="since">Since 0.8</p>
|
2516
|
+
</div>
|
2517
|
+
<hr>
|
2518
|
+
<div class="refsect2">
|
2519
|
+
<a name="clutter-do-event"></a><h3>clutter_do_event ()</h3>
|
2520
|
+
<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>
|
2521
|
+
<p>
|
2522
|
+
Processes an event.
|
2523
|
+
</p>
|
2524
|
+
<p>
|
2525
|
+
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>
|
2526
|
+
associated to it.
|
2527
|
+
</p>
|
2528
|
+
<p>
|
2529
|
+
This function is only useful when embedding Clutter inside another
|
2530
|
+
toolkit, and it should never be called by applications.
|
2531
|
+
</p>
|
2532
|
+
<div class="variablelist"><table border="0" class="variablelist">
|
2533
|
+
<colgroup>
|
2534
|
+
<col align="left" valign="top">
|
2535
|
+
<col>
|
2536
|
+
</colgroup>
|
2537
|
+
<tbody><tr>
|
2538
|
+
<td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td>
|
2539
|
+
<td>a <a class="link" href="clutter-Events.html#ClutterEvent" title="union ClutterEvent"><span class="type">ClutterEvent</span></a>.</td>
|
2540
|
+
</tr></tbody>
|
2541
|
+
</table></div>
|
2542
|
+
<p class="since">Since 0.4</p>
|
2543
|
+
</div>
|
2544
|
+
</div>
|
2545
|
+
</div>
|
2546
|
+
<div class="footer">
|
2547
|
+
<hr>
|
2548
|
+
Generated by GTK-Doc V1.18.1</div>
|
2549
|
+
</body>
|
2550
|
+
</html>
|